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About this Manual 


This manual contains reference information for the tasks of system administration. 
data base administration, appNcation programming, and operation. It presents 
detailed information on Structured Query Language/400 (SQL/400), including 
syntax, usage notes, keywords. and examples for each of the SQL statements 
implemented on the AS/400 system. 


Who Should Use This Manual 


This book is intended for programmers who want to write applications that will use 
SQL to access an AS/400 system data base. 


What You Should Know 


It is assumed that you possess an understanding of system administration, data 
base administration, or application programming in the AS/400 system 
environment, as provided by the SQL Programmer's Guide. and that you have 
some knowledge of the following: 


e A programming language (RPGIII. COBOL85. and/or PL/I) 

e Structured Query Language (SQL) 
This book is a reference rather than a tutorial It assumes you are already familiar 
with SQL programming. This book also assumes that you will be writing 
applications solely for the AS/400 system environment and therefore presents the 
full functions of the AS/400 system. Should you be planning applications which will 
be ported to other Systems Applications Architecture (SAA) environments, it will be 


necessary for you to reference the appropriate SAA books in addition to this one. 
(See “Systems Application Architecture’ on page 1.) 


How This Manual Is Organized 
This book has the following sections: 
¢ Chapter 1 is an overview to SAA and SQL Concepts. 


e Chapter 2 describes the basic syntax of SQL and language elements that are 
common to many SQL statements. 


e Chapter 3 describes the column and scalar functions. 


e Chapter 4 describes the three forms of query that are used to specify a result 
table. 


e Chapter 5 contains syntax diagrams. semantic descriptions, rules, and usage 
examples of SQL statements written in RPG. COBOL or PL/I. 


e The Appendixes contain information about the SQL limits and the SQLCA and 
SQLDA. 


This manual also contains a glossary of terms and abbreviations and an index. 
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Related Online 


Help for Displays 


Index Search 


Information 


The following online information is available on the AS/400 system. You can press 
the Help key a second time to see an explanation of how the online information 
works, including the index search function. 


You can press the Help key on any display to see information about the display. 
There are two types of help available: 


General 
Specific 


General help explains the purpose of the display. General help appears if you 
press the Help key when the cursor is outside the areas for which specific help is 
available. 


Specific help explains the field on which the cursor is positioned when you press 
the Help key. For example, it describes the choices available for a prompt. Ifa 
system message appears at the bottom of the display, position the cursor on the 
message and press the Help key to see information about the cause of the 
message and the appropriate action to take. 


To exit the online information, press F3 (Exit) You return to the display on which 
you pressed the Help key. 


Index search allows you to specify the words or phrases you want to see 
information about. To use index search, press the Help key. then press F11 
(Search index). 


Help for Control Language Commands 


Online Education 


To see prompts for parameters for a control language command. type the 
command, then press the Help key or F4 (Prompt) instead of the Enter key 


AS/400 system online education provides tutorials on a wide variety of topics. To 
use the online education. press F13 (User support) on any system menu to show 
the User Support menu. Then select the option to use online education 


Question-and-Answer Function 
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The question-and-answer (Q & A) function provides answers to questions you may 
have about using an AS/400 system. To use the Q & A function. press F13 (User 
support) on any system menu to show the User Support menu Then select the 
option to use the question-and-answer function. 


C Related Printed Information 


If you need more information about using SQL statements statement syntax and 
parameters, see Programming: Structured Query Language Programmer's Guide, 
3C21-9609 


If you need more information about the interactive data definition utility, see 
Utilities: Interactive Data Definition Utility User’s Guide. $C21-9657. 


For more information about AS/400 system security. see Programming: Security 
Guide, SC21-8083. 


For more information about entering source and syntax checking of host language 
and SQL statements, see the Utilities: Source Entry Utility User's Guide and 
Reference, SCO9-1172. 


For more information about AS/400 system control language commands and 
AS/400 system programming, see the following: 


e Languages. ANSI’85 COBOL User’s Guide and Reference, SCO9-1158 
e Languages: PL/I Reference Summary, SX09-1051 

e Languages: PL/I User’s Guide and Reference, SCO9-1156 

e Languages: RPG II] User’s Guide and Reference. SC0Q9-1161 

e Programming: Command Reference Summary, SC21-8076 

e Programming: Control Language Programmer's Guide, SC21-8077 


e Programming. Control Language Reference, SC21-8103 


For more information about data bases, see the following: 
e Programming: Backup and Recovery Guide, SC21-8079 
e Programming: Data Base Guide, $C21-9659 


e Programming: Data Description Specifications Reference, SC21-9620 
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C Chapter 1. Introduction 


Systems Application Architecture 


The AS/400 system is a part of IBM’s Systems Application Architecture (SAA). SAA 
is a definition — a set of software interfaces, conventions, and protocols that 
provide a framework for programmers who want to write applications with 
cross-system consistency. 


Systems Application Architecture: 


e Defines a common programming interface that you can use to develop 
applications that can be integrated with each other and transported to run in 
multiple SAA environments. 


e Defines common communications support that you can use to connect 
applications, systems, networks, and devices. 


e Defines a common user access that you can employ to achieve consistency in 
panel layout and user interaction techniques. 


e Offers some common applications written by IBM using the above. 


The following publications may prove useful in preparing applications which 
adhere to the SAA definitions: 


\ Systems Application Architecture: An Overview (GC26-4341) 


Introduces SAA concepts, and identifies the environments and elements that 
participate. 


Common User Access: Panel Design and User Interaction (SC26-4351) 


Defines the common user access for Personal Computers and System/370 and 
AS/400 system terminals, including panel layout and user interaction 
techniques. 


Systems Application Architecture Writing Applications: A Design Guide 
(SC26-4362) 


Provides guidance on developing application programs that are consistent and 
portable across the SAA environments. These applications will use the 
common programming interfaces and implement the common user access 
specification. 


Systems Application Architecture Common Programming Interface Database 
Reference (SC26-4348) 


The information presented in this manual is a subset in the libraries of the SAA 
implementing products. As such, this book gives limits and rules which assist 
you in preparing portable programs. Since SAA is a definition and not a 
product, rules and limits may not be enforced by all products. 
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How to Read the Syntax Diagrams J 
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e Read the syntax diagrams from left to right, from top to bottom, following the 


path of the line. 
The »»—— symbol indicates the beginning of a statement. 
The ——» symbol indicates that the statement syntax is continued. 


The »—— symbol indicates that a line is continued from 
the previous line. 


The ———*~< symbol] indicates the end of a statement. 


Diagrams of syntactical units other than complete statements start 
with the »—— symbol and end with the ——~ symbol. 


Required items appear on the horizontal line (the main path). 


>>—STATEMENT requ red=) (eh —— eee ee 


Optional items appear below the main path. 


pe —STAT EMENTN +. 
__optional—item— 


If you can choose from two or more items, they appear vertically stacked. 


If you must choose one of the items, one item of the stack appears on the main 


path. ) 
peel ENE ae ede) red-—choice — 
required-choice2 


If choice of an item is optional, the entire stack appears below the main path. 


5A ee 
| eetional-chotcel 
optional—choice2 


An arrow returning to the left, above the main line, indicates an item that can 


be repeated. 
ee ee ees 


A repeat arrow above a stack indicates that you can make more than one 
choice from the stacked items, or repeat a single item. 


p>—§ STATEMENT 


Keywords appear in uppercase (for example, CREATE TABLE). They must be 
spelled exactly as shown. Variables appear in all lowercase letters (for 
example, column-name). They represent user-supplied names. 


If punctuation marks, parentheses, arithmetic operators, or such symbols are 
shown, you must enter them as part of the syntax. 


Sometimes a single variable represents a set of several parameters. For example, 
in the following diagram, the variable parameter-block can be replaced by any of 
the interpretations of the diagram that is headed parameter-block: 


sa as a ce ere a 
_parameter—bl ock 


parameter—block 


>———PARM1 


SS 
L__PARM2 2 ee ee 
ae 


Example: STATEMENT CLAUSE1 
or STATEMENT PARM1 
or STATEMENT PARM2 PARM4 


Some SQL Concepts 


Static SQL 


The Structured Query Language (SQL) is the language used to access data ina 
relational data base. SQL is unlike many programming and data languages 
because you do not have to code a sequence of instructions explaining how to get 
to the data. SQL lets you select data using a single statement directed toward the 
data base manager. It is the function of the data base manager to access and to 
maintain the data. 


SQL provides full data definition and data manipulation capabilities. You can use it 
to define objects such as indexes, tables, and views. You can also retrieve, insert, 
update, and delete data and control access authorization to data. 


The SQL statements can be: 


e Embedded inside application programs written in other languages, such as 
RPG, COBOL, and PL/I. 


This is called static SQL. The SQL statements are present in the program at 
the time it is precompiled. 


e Typed in from a terminal or built by a program. This is called dynamic SQL. 
The SQL statements are not provided to the data base manager until the 
program runs. 


SQL programmers can write source programs containing static SQL statements. 
Before a RPG, COBOL, or PL/I program containing static SQL statements is 
compiled, the appropriate SQL precompiler flags the SQL statements as comments 
and includes the code necessary to call the data base manager. Then the compiler 
can process the program. The precompiler also checks the syntax of the SQL 
statements. 
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Dynamic SQL 


Tables 


Indexes 


Catalog 


Views 
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A capability to enter SQL statements from a terminal is part of the architecture of J 
SQL. You can write programs that read SQL statements from terminals. Programs 

that you write use dynamic SQL to process SQL statements and present the results 

to users. Dynamic SQL allows you to create your own query programs, tailored to 

your users and designed for your specific needs. 


A relational data base is perceived as a collection of tables. Tables are logical 
structures maintained by the data base manager. Tables are made up of columns 
and rows. There is no inherent order of the rows within atable. At the intersection 
of every column and row is a specific data item called a va/ue. Acolumn is a set of 
values of the same type. Arow is a sequence of values such that the nth value is a 
value of the nth column of the table. 


A base tabie is created with the CREATE TABLE statement and is used to hold 
pertinent user data. A result table is a set of rows that the data base manager 
selects or generates from one or more base tables. 


An index is an ordered set of pointers to rows of a base table. Each index is based 
on the values of data in one or more table columns. An index ts an object that is 
separate from the datain the table. When you request an index, the data base 
manager builds this structure and maintains it automatically. 


Indexes are used by the data base manager to: } 


e Improve performance. In most cases, access to data is faster than without an 
index. 


e Ensure uniqueness. A table with a unique index cannot have rows with 
identical keys. (A key is a column, or an ordered collection of columns, on 
which the index is created.) 


The data base manager maintains a set of tables and views containing information 
about data in the data base. The catalog tables contain information about tables, 
views, and indexes. 


Tables and views in the catalog are like any other data base tables and views. If 
you have authorization, you can use SQL statements to look at data in the catalog 
views the same way you retrieve data from any other table in the AS/400 system. 
The data base manager ensures that the catalog contains accurate descriptions of 
the data base at all times. 


Views provide an alternative way of looking at the data in one or more tables. 


Like tables, views have rows and columns with no inherent order of rows. You 

specify view names in the FROM clause of the SELECT statement just as you 

specify table names. You can create views and authorize their use by users who 

use them like tables. Certain operations are not valid on views; otherwise. users 3 
never need know they are working with a view and not with a table. » 


A table has a storage representation, but a view does not. When a view is created, 
its definition is stored in the catalog. No data is stored, and, therefore, no index 
can be created for aview. However, an index created for a table on which a view 
is based may improve the performance of operations on the view. 


Application Processes, Concurrency, and Recovery 


All SQL programs execute as part of an application process (job). An application 
process involves the execution of one or more programs, and is the unit to which 
the data base manager allocates resources and locks. 


More than one application process may request access to the same data at the 
same time. Locking is the mechanism used to maintain data integrity under such 
conditions, preventing, for example, two application processes from updating the 
same row of data simultaneously. 


The data base manager acquires locks in order to prevent uncommitted changes 
made by one application process from being changed by any other application 
process. The data base manager will release all locks it has acquired on behalf of 
an application process when that process terminates, but an application process 
itself can also explicitly request that locks be released sooner. This operation is 
called commit. 


The recovery facilities of the data base manager provide a means of “backing out” 
uncommitted changes made by an application process. This might be necessary in 
the event of a failure on the part of an application process An application process 
itself, however, can explicitly request that its data base changes be backed out. 
This operation is called ro//back. 


A unit of recovery (also known as a /ogical unit of work), is a recoverable sequence 
of operations within an application process. An application process represents a 
single unit of recovery, but may be broken down into many shorter units of 
recovery by means of commit or rollback operations. Thus, a unit of recovery is 
effectively begun by the initiation of an application process, or by the termination of 
a previous unit of recovery. It is effectively terminated by a commit operation, a 
rollback operation, or the termination of an application process. A commit or 
rollback operation affects only the data base changes made within the unit of 
recovery it terminates. While these changes remain uncommitted, other 
application processes are unable to change them, and they can be backed out. 
Once committed, these data base changes are accessible by other application 
processes, and can no longer be backed out by means of a rollback. Locks 
acquired by the data base manager on behalf of an application process are held 
until the termination of a unit of recovery. A lock explicitly acquired by a LOCK 
TABLE statement may be held past the termination of a unit of recovery if COMMIT 
HOLD or ROLLBACK HOLD is used to terminate the unit of recovery. A cursor may 
implicitly lock the row at which it is positioned. This lock will prevent another 
cursor inthe same application process (or a DELETE or UPDATE statement not 
associat::d with that cursor) from acquiring a lock on the same row. 


The tnitiation and termination of a unit of recovery define points of consistency 
within an application process. For example, a banking transaction might involve 
the transfer of funds from one account to another. Such a transaction would 
require that these funds be subtracted from the first account. and added to the 
second. Following the subtraction step, the data 1s inconsistent. Only after the 
funds have been added to the second account is consistency reestablished. When 
both steps are complete, the commit operation can be used to terminate the unit of 
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recovery, thereby making the changes available to other application processes. If 
an application process failure occurs before the unit of recovery terminates, the 
data base manager will back out uncommitted changes in order to restore the 
consistency of the data that it assumes existed when the unit of recovery was 


initiated. 


Jo 


C 
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Characters 


Tokens 


This chapter describes the basic syntax of SQL and language elements that are 
common to many SQL statements. Although examples are shown and most terms 
are defined before they are used. this chapter is not a tutorial. It is intended for 
those who require a definitive description of the following language elements. 


e “Characters” 

e “Tokens” 

e “Identifiers” on page 8 

e “Naming Conventions” on page 9 
e “Authorization IDs” on page 11 

e “Data Types” on page 12 

e “Basic Operations” on page 14 

e “Constants” on page 17 

e “Special Registers” on page 18 

e “Column Names’ on page 19 

e “Host Variables” on page 21 

e “Expressions” on page 23 

e “Predicates” on page 26 

e “Search Conditions” on page 29. , 


' 


The basic symbols of the language are characters from the EBCDIC collating 
sequence and code points. Characters are classified as letters, digits, or special 
characters. A /etter is any one of the Uppercase or lowercase characters A through 
Z plus the three characters reserved as alphabetic extenders for national 
languages (#, @. and $ in the United States). A digit is any one of the characters 0 
through 9. A special character is any character other than a letter or a digit. 


The basic syntactical units of the language are called tokens. A token consists of 
one or more characters, excluding blanks and characters within a string constant 
or delimited identifier. (These terms are defined later.) 


Tokens are classified as ordinary or delimiter tokens: 


e An ordinary token is a numeric constant, an ordinary identifier, a host 
identifier, or a keyword. 


e A delimiter token is a string constant. a delimited identifier, an operator 
symbol, or any of the special characters shown in the syntax diagrams. A 
question mark is also a delimiter token when it serves as a parameter marker, 
as explained under “PREPARE” on page 101. 
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Spaces 
A space is a sequence of one or more blank characters. Tokens, other than string 
constants must not include a space. Any token may be followed by a space. Every 
ordinary token must be followed by a delimiter token or a space. If the syntax does 
not allow an ordinary token to be followed by a delimiter token, that ordinary token 
must be followed by a space. 


Uppercase and Lowercase 
Ordinary tokens are folded to uppercase. Delimiter tokens are never folded to 
uppercase. Thus, the statement: 


select * from CORPDATA.TEMPL where lastname = ‘Smith'; 


is equivalent, after folding, to: 


SELECT * FROM CORPOATA.TEMPL WHERE LASTNAME = 'Smith'; 


H) 


Identifiers 


An identifier is a token that is used to form a name. 


An identifier used to form the name of a host variable or structure is called a host 

identifier. The rules for forming a host identifier depend on the host language. For 

example, the rules for forming a host identifier in a COBOL program are the same 

as the rules for forming a user-defined word in COBOL, except that host identifiers 

must begin with a letter. Double byte character set (DBCS) identifiers are not 

supported. There are two types of SQL identifiers: ordinary identifiers and 
delimited identifiers. S) 


e An ordinary identifier is a letter followed by zero or more characters, each of 
which is a letter, a digit, or the underscore character. An ordinary identifier 
must not be identical to a reserved word. (See Programming: Structured 
Query Language Programmer's Guide for a list of reserved words.) 


e A delimited identifier is a sequence of one or more characters of the standard 
characters set enclosed within SQL escape characters. The escape character 
is the quotation mark (") except for: 


— Dynamic SQL when the SQL string delimiter is set to the quotation mark. 
Here the SQL escape character is the apostrophe {'). 


— COBOL application programs. A COBOL precompiler option specifies 
whether the escape character is the quotation mark (") or the apostrophe 
('). 

The following characters are not allowed within delimited identifiers: 


— A blank (X'40') 

— An asterisk (X'5C') 

— An apostrophe (X'7D') 

— A question mark (X'6F') 

— A quotation mark (X'7F') 

— X'QO' through X'3F' and X'FF' 


Here are examples of SQL identifiers: 
WEEKLYSAL WEEKLY SAL "WEEKLY.SAL™ —»- $500 7 ) 
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An identifier has a maximum length of 10 bytes. This limit includes the escape 
characters of a delimited identifier, unless all characters within the delimiters 
would form an ordinary identifier. For example, “ABCDEF GHIJ” is valid, but 
“abcdefghij” is not valid. 


An identifier that begins with a number (0-9), or contains a period {.) must be a 
delimited identifier. Delimited identifiers with lowercase characters are not folded 


to uppercase. 


Naming Conventions 


The rules for forming a name depend on the type of the object designated by the 
name. The syntax diagrams use different terms for different types of names. The 
following list defines these terms. 


auth-id 


column-name 


correlation-name 


cursor-name 
database-name 


descriptor-name 


host-variable 


An identifier that designates a user. An auth-id is a user 
profile name on the AS/400 system. An auth-id containing a 
period (.) cannot be used as a qualifier unless it is enclosed 
in delimiters. SQL will use ten characters of the name, but 
only eight are allowed for the special register USER. If more 
than eight characters are found for USER, a negative value 
is returned in the SQLCODE field of the SQLCA. 


A qualified or unqualified name that designates a column of 
a table ora view. The unqualified form of a column-name is 
an identifier. The qualified form is a qualifier followed by a 
period and an identifier. The qualifier is a table-name, a 
view-name, or a correlation-name. 


Column names cannot be qualified with system names in the 
form database-name/table-name.column-name, except in 
the COMMENT ON and LABEL ON statements. If column 
names need to be qualified, and correlation names are 
allowed in the statement, a correlation must be used to 
qualify the column. Column names can be SQL delimited 
identifiers, but the characters within the delimiters must not 
include special characters. 


An identifier that designates a table, a view, or individual 
rows of a table or view. 


An identifier that designates an SQL cursor. 
An identifier that designates a database. 


A host identifier that designates an SQL descriptor area 
(SQLDA). See “Host Variables” on page 21 fora 
description of a host identifier. A host variable that 
designates an SQL descriptor area must be of the form 
:host-variable. The form 
:host-variable:indicator-variable is not allowed. 


A sequence of tokens that designates a host variable. A 
host variable includes at least one host identifier as 
explained in “Host Variables” on page 21. 
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index-name A qualified or unqualified name that designates an index. 
The unqualified form of an index-name is an identifier. The 2 
qualified form of an index-name depends on whether the 
naming option ("SQL or *SYS) was specified on the STRSQL 
or CRTSQLxxx command (where xxx is RPG, CBL, or PLI). 


For SQL names, the unqualified index-name in an SQL 
statement is implicitly qualified by the authorization-ID of the 
statement. The qualified form is the database-name 
followed by a period (.) and an identifier. 


For system names, the unqualified index-name in an SQL 

Statement is implicitly qualified by “LIBL (user library list). 
The qualified form is a database-name followed by a slash 
(/) and an identifier. 


statement-name An identifier that designates a prepared SQL statement. 


table-name A qualified or unqualified name that designates atable. The 
unqualified form of a table-name is an identifier. The 
qualified form of a table-name depends on whether the 
naming option ("SQL or *SYS) was specified on the STRSQL 
or CRTSQLxxx command (where xxx is RPG, CBL, or PLI). 


For SQL names, the unqualified table-name in an SQL 
statement is implicitly qualified by the authorization-ID of the 
statement. The qualified form is the database-name 
followed by a period {.) and an identifier. 


For system names, the unqualified table-name in an SQL 

Statement is implicitly qualified by “LIBL (user library list). J@ 
The qualified form is a database-name followed by a slash 

(/) and an identifier. 


view-name A qualified or unqualified name that designates a view. The 
unqualified form of a view-name is an identifier. The 
qualified form of a view-name depends on whether the 
naming option (“SQL or *SYS) was specified on the STRSQL 
or CRTSQLxxx command (where xxx is RPG, CBL, or PLI). 


For SQL names, the unqualified view-name in an SQL 
statement is implicitly qualified by the authorization-ID of the 
statement. The qualified form is the database-name 
followed by a period (.) and an identifier. 


For system names, the unqualified view-name in an SQL 
statement is implicitly qualified by “LIBL (user library list). 
The qualified form is a database-name followed by a slash 
(/) and an identifier. 


SQL Names and System Names: Special Considerations 
An override CL command (OVRDBF) may be specified that overrides an SQL or 
system name to another object name for data manipulation SQL statements. 
Overrides are ignored for data definition SQL statements. See Programming: Data 
Management Guide for more information about the override function. 
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You can access tables or views using either SQL names or system names. If you 
choose to use SQL names: 


e If a qualified name is specified, SQL/400 attempts to find the object in the 
specified data base. 


e lf an object is unqualified, it is implicitly qualified by the authorization ID of the 
statement. Because the authorization ID can change based on user, most SQL 
syntax names should be qualified. 


If you choose to use system names, the following rules apply: 


e lf a qualified name is specified, SQL/400 attempts to find the object in the 
specified library. 


e If an unqualified object name is specified, SQL/400 searches the library list 
(*LIBL) 


Authorization IDs 


An authorization ID is a user profile. It is a character string of not more than 10 
characters that designates a set of privileges. 


The data base manager uses authorization IDs to provide: 
1. Authorization checking of SQL statements, and 


2. Implicit qualifiers for the names of tables, views, and indexes. 


An authorization ID applies to every SQL statement. The authorization ID that 
applies to a static SQL statement is the authorization ID of the owner of the 
program. The authorization ID that applies to a dynamic SQL statement is the 
authorization ID of the user running the program. This is called the run-time 
authorization ID. 


An auth-id specified in an SQL statement should not be confused with the 
authorization ID of the statement. For example, assume that SMITH is your user 
profile and you execute the following statement interactively: 


GRANT SELECT ON TDEPT TO KEENE 


SMITH is the run-time authorization ID, and the data base manager therefore 
checks to ensure that SMITH is authorized to issue the statement. KEENE is the 
auth-id specified in the statement. A group user profile may also be used when 
checking authority for an SQL statement. For information on group user profiles, 
see Programming: Security Guide. 


Here are two examples of a table-name, view-name, or index-name: 
NAME 1 SMITH. NAME1 
If SMITH is the authorization ID of the statement that contains NAME1, NAME1 


identifies the same object as SMITH.NAME1. Otherwise, NAME1 and 
SMITH.NAME1 identify different objects. 


Chapter 2. Language Elements 11 


Data Types 3 


The smallest unit of data that can be manipulated in SQL is called a value. How 
values are interpreted depends on the data type of their source. The sources of 
values are constants, columns, host variables, functions, expressions, and special 
registers. 


The basic data types are character string, integer, floating-point, numeric, and 
decimal. Floating-point values are further classified as single precision and double 
precision, while integers are further classified as small integer and large integer. 
Integers may be specified in some host variables as having precision and scale. 


All data types include the null value. The null value is a special value that is 
distinct from all nonnull values and thereby denotes the absence of a (nonnull) 
value. Im SQL/400, a column of a table cannot contain a null value. 


Character Strings 
A character string is a sequence of bytes. The length of the string is the number of 
bytes in the sequence. If the length is zero, the value is called the empty string. 
This value should not be confused with the null value. 


Fixed-Length Strings 
All values of a fixed-length string column have the same length, which is 
determined by the length attribute of the column. The length attribute must be 
between 1 and 32766 inclusive. 


String Variables 2 
Fixed-length string variables can be defined in all host languages. Varying-length 
string variables can be directly defined in all host languages except RPG. 


Mixed Data in Character Strings 
Character strings may contain sequences of double-byte characters, each 
preceded by a “shift-out” character and followed by a “shift-in” character. A string 
containing one or more such sequences is called “mixed.” The principal use of 
mixed data is to represent national language texts. 


SQL does not recognize subclasses of double-byte characters, and does not assign 
any specific meaning to particular double-byte codes. However, if you choose to 
use mixed data, then two single-byte EBCDIC codes are given special meanings: 


e X'OE', the “shift-out” character, is used to mark the beginning of a sequence of 
double-byte codes. 


e X'OF', the “shift-in” character, is used to mark the end of a sequence of 
double-byte codes. 
In order for SQL/400 to recognize double-byte characters in a mixed string. the 


following condition must be met: 


e Within the string, the double-byte characters must be enclosed between paired 
shift-out and shift-in characters. 


The pairing is detected as the string is read from left to right. The code X'QE' 
is interpreted as a shift-out character if X'QF' occurs later; otherwise, it is a 3 
invalid. The first X'OF' following the X'OE' is the paired shift-in character. 
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Numbers 


Small Integer 


Large Integer 


There must be an even number of bytes between the paired characters, and 
each pair of bytes is considered to be a double-byte character. There may be 
more than one set of paired shift-out and shift-in characters in the string. 


The length of a mixed string is its total number of bytes, counting two bytes for 
each double-byte character and one byte for each shift-out or shift-in character. 


When the system value QIGC indicates that DBCS is allowed, CREATE TABLE will 
create character columns as OPEN fields, unless FOR BIT DATA or FOR SBCS is 
specified. The SQL user will see these as character fields, but the system data 
base support will see them as DBCS-Open fields. For a definition of the 
DBCS-Open field, see Programming: Data Description Specifications Reference. 


The numeric data types are described below. You can define small integer, large 
integer, decimal and numeric variables in all host languages. Floating-point 
variables can be defined only in PL/I. 


All numbers have a sign and a precision. The precision is the total number of 
binary or decimal digits excluding the sign. The Sign is positive if the value is zero. 


A small integer is a binary integer with a precision of 15 bits. The range of small 
integers is -32768 to 32767. 


AS/400 system host variables in languages and AS/400 system physical and logical 
files support precision and scale. 


A large integer is a binary integer with a precision of 31 bits. The range of large 
integers is -2147483648 to +2147483647. 


AS/400 system host variables in languages and AS/400 system physical and logical 
files support precision and scale. 


Single Precision Floating-Point 


A single precision floating-point number is a IEEE short (32 bits) floating-point 
number. The range of magnitudes is approximately 1.17549436 * 10**-38 to 
3.40282356 * 10**38. 


Double Precision Floating-Point 


Decimal 


A double precision floating-point number is 64 bits long. The range of magnitudes 
iS approximately 2.2250738585072014 * 10**-308 to 1.7976931348623158 * 10**308. 


A decimal value is a packed decimal number with an implicit decimal point. The 
position of the decimal point is determined by the precision and the scale of the 
number The scale, which is the number of digits in the fractional part of the 
number, cannot be negative or greater than the precision. The maximum precision 
is 31 digits. 


All values of a decimal column have the same precision and scale. The range of a 
decimal variable or the numbers in a decimal column is -n to +n, where the 
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Numeric 


absolute value of nis the largest number that can be represented with the 
applicable precision and scale. The maximum range is -10**31 +1 to 10°*31-1. ) 


A numeric number is a zoned decimal number with an implicit decimal point. The 
position of the decimal point is determined by the precision and the scale of the 
number. The scale, which is the number of digits in the fractional part of the 
number, cannot be negative or greater than the precision. The maximum precision 
Is 31 digits. 


All values of a numeric column have the same precision and scale. The range of a 
numeric variable or the numbers in a numeric column is -n to +n, where the 
absolute value of nis the largest number that can be represented with the 
applicable precision and scale. The maximum range Is -10*"31 +1 to 10**31-1. 


Basic Operations 


The basic operations of SQL are assignment and comparison. Assignment 
operations are performed during the execution of INSERT, UPDATE, FETCH, and 
SELECT INTO statements. Comparison operations are performed during the 
execution of statements that include predicates and other language elements such 
as MAX, MIN, DISTINCT, GROUP BY, and ORDER BY. 


The basic rule for both operations is that numbers and strings are not compatible. 
Thus, numbers and strings cannot be compared. numbers cannot be assigned to 
string columns or variables, and strings cannot be assigned to numeric columns or 


variables. 5 


For assignment operations, a null value cannot be assigned to a column, nor to a 
host variable that does not have an associated indicator variable. (See “Host 
Variables” on page 21 for a discussion of indicator variables.) 


Numeric Assignments 


The basic rule for numeric assignments Is that the whole part of a number is never 
truncated. If the whole part js truncated, a negative value is returned in the 
SQLCODE field of the SQLCA. If necessary, the fractional part of a number is 
truncated. 


Decimal, Numeric, or Integer to Floating-Point 
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Floating-point numbers are approximations of real numbers. Hence, when a 
decimal, numeric, or integer number is assigned to a floating-point column or 
variable, the result may not be identical to the original number. 


Because of the added length of double precision floating-point numbers (64 bits 
rather than the 32 bits of a single precision value). the approximation will be more 
accurate if the receiving column or variable is defined as double precision rather 
than single precision. 


Decimal, Numeric, or Floating-Point to Integer 
When a decimal, numeric, or floating-point number is assigned to a binary integer 
column or variable, the number is converted, if necessary, to the precision and the 
scale of the target. If the scale of the target is zero, the fractional part of the 
number is lost. The necessary number of leading zeros is appended or eliminated, 
and, in the fractional part of the number, the necessary number of trailing zeros is 
appended, or the necessary number of trailing digits is eliminated. 


Decimal or Numeric to Decimal or Numeric 
When a decimal or numeric number is assigned to a decimal or numeric column or 
variable, the number is converted, if necessary, to the precision and the scale of 
the target. The necessary number of leading zeros is appended or eliminated, and, 
in the fractional part of the number, the necessary number of trailing zeros is 
appended, or the necessary number of trailing digits is eliminated. 


Integer to Decimal or Numeric 
When an integer is assigned to a decimal or numeric column or variable, the 
number is converted first to a temporary decimal number and then, if necessary, to 
the precision and scale of the target. If the scale of the integer is zero, the 
precision of the temporary decimal number is 5,0 for a small integer, or 11,0 fora 
large integer. 


Floating-Point to Decimal or Numeric 
When a single or double precision floating-point number is converted to decimal or 
numeric, the number is first converted to a temporary decimal! or numeric number 
of precision 31 and then, if necessary, truncated to the precision and scale of the 
target. In this conversion, the number is rounded (using floating-point arithmetic) 
to a precision of 31 decimal digits. As a result, a number less than 0.5*10-3' is 
reduced to 0. The scale is given the largest possible value that allows the whole 
part of the number to be represented without loss of significance. 


To COBOL or RPG Integers 
Assignment to integer variables takes into account any scale specified for the host 
variable. However, assignment to integer variables uses the full size of the 
integer. Thus, the value placed in the data item may be larger than the maximum 
precision specified for the host variable. 


For example, given the following COBOL statement: 


01 A PIC $99V99 COMP-4. 
ASSIGN 123.45 TO A. 


The value placed in A will be 123.45, even though A has been defined with only 2 
digits to the left of the decimal point. 


String Assignments 
The basic rule for string assignments is that the length of a string assigned to a 
column must not be greater than the length attribute of the column. (Trailing 
blanks are included in the length of the string.) 


When a string is assigned to a fixed-length string column or variable and the length 


of the string is less than the length attribute of the target, the string is padded on 
the right with the necessary number of EBCDIC or double-byte blanks. 
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When a string of length n is assigned to a varying length string variable with a 
maximum length greater than n, the characters after the nth character of the J 
variable are undefined. 


When a string is assigned to a variable and the string is longer than the length 
attribute of the variable, the string is truncated on the right by the necessary 
number of characters. When this occurs, the value 'W' is assigned to the 
SQLWARN‘1 field of the SQLCA. When a string is assigned to a column and the 
string is longer than the length attribute of that column, an error occurs. See 
Appendix B, “SQLCA and SQLDA Control Blocks” on page 119, for a description 
of the SQLCA. 


If the string contains mixed data, the assignment rules may require truncation 
within a sequence of double-byte codes. In that case, truncation loses the shift-in 
character that ends the double-byte sequence. To prevent that loss, one additional 
character may be cut from the end of the string; then a shift-in character is 
appended before the assignment is made. In the truncated result, there is always 
an even number of bytes each shift-out character and its matching shift-in 
character. 


Numeric Comparisons 


Numbers are compared according to their algebraic value. Conversion for the 
comparison is handled internally, and packed decimal ts used if the numbers are 
any combination of decimal and numeric numbers. 


If one number is an integer and the other is decimal, the comparison is made with 
a temporary copy of the integer, which has been converted to decimal. -) 


When decimal numbers with different scales are compared, the comparison is 
made with a temporary copy of one of the numbers that has been extended with 
trailing zeros so that its fractional part has the same number of digits as the other 
number. 


If one number is floating-point and the other is integer, decimal, or numeric, the 
comparison is made with a temporary copy of the other number, which has been 
converted to double precision floating-point. 


Two floating-point numbers are equal only if the bit configurations of their 
normalized forms are identical. 


String Comparisons 
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The comparison of two strings is determined by the comparison of the 
corresponding bytes of each string. The strings must not be longer than 32,766 
bytes. If the strings do not have the same length, the comparison is made with a 
temporary copy of the shorter string that has been padded on the right with blanks 
so that it has the same length as the other string. 


Two strings are equal if they are both empty or if all corresponding bytes are 

equal. Varying-length strings that differ only in the number of trailing blanks are 

considered equal. If two strings are not equal, their relation is determined by the 

comparison of the first pair of unequal bytes from the left end of the strings. This 

comparison is made according to the EBCDIC collating sequence. 9 


C 


Constants 


A constant (sometimes called a literal) specifies a value. Constants are classified 
as string constants or numeric constants. Numeric constants are further classified 
as integer, floating-point, or decimal. 


All constants have the attribute NOT NULL. A negative sign in a numeric constant 
with a value of zero is ignored. 


Integer Constants 


An integer constant specifies an integer as a signed or unsigned number, of at 
most 10 digits, that does not include a decimal point. The data type of an integer 
constant is large integer, and its value must be within the range of a large integer. 


Here are some examples of integer constants: 
64 -15 +100 32767 720176 


In syntax diagrams, the term “integer” is used for an integer constant that must not 
include a Sign. 


Floating-Point Constants 


A floating-point constant specifies a floating-point number as two numbers 
separated by an E. The first number may include a sign and a decimal point: the 
second number may include a sign, but not a decimal point. The value of the 
constant is the product of the first number and the power of 10 specified by the 
second number; it must be within the range of floating-point numbers. The number 
of characters in the constant must not exceed 24. Excluding leading zeros, the 
number of digits in the first number must not exceed 17 and the number of digits in 
the second must not exceed 3. The data type of a floating-point constant is double 
precision floating-point. 


Here are some examples of floating-point constants: 
15E1 2.ED 2a eed toseae 


Decimal Constants 


A decimal constant specifies a decimal number as a signed or unsigned number 
that includes a decimal point, and at most 31 digits. The precision is the total 
number of digits (including leading and trailing zeros) rounded to the next highest 
odd number; the scale is the number of digits to the right of the decimal point 
(including trailing zeros). 


Here are some examples of decimal constants: 


2959 1000. -15. +37589. 3333333333 


Character String Constants 


There are two forms of character string constant: 


e A sequence of characters that starts and ends with a string delimiter ('). This 
form of string constant specifies the character string contained between the 
string delimiters. The length of the character string must not be greater than 
32765. Two consecutive string delimiters are used to represent one string 
delimiter within the character string. 


Chapter 2. Language Elements 17 


e An X followed by a sequence of characters that starts and ends with a string 
delimiter. The characters between the string delimiters must be an even oe 
number of hexadecimal digits. The number of hexadecimal digits must not 
exceed 32764. A hexadecimal digit is a digit or any of the letters A through F 
(upper or lower case). Under the conventions of hexadecimal notation, each 
pair of hexadecimal digits represents a character. This form of string constant 
allows you to specify characters that do not have a keyboard representation. 


Here are some examples of character string constants: 


"12/14/1985! 132! 'DON''T CHANGE! ni X"F FFF! 


Alternative Syntax 


Data Separator 
You have the option of specifying whether the decimal point in a numeric constant 
is represented by a period or acomma. The default value for Interactive SQL is 
indicated by the system value QDECFMT. This value can be set through the CL 
command CHGSYSVAL. For information on this command, see Programming. 
Control Language Reference. 


“PERIOD, “COMMA, and *SYSVAL are mutually exclusive COBOL and RPG 
precompiler options that specify the character that represents the decimal point in 
SQL statements embedded in the program. If “PERIOD is specified, the decimal 
point is the period: if “COMMA Is specified, the decimal point is the comma: if 
*SYSVAL is specified, the decimal point is determined by the system value 


QDECFMT. ) 


In PL/I, the usage is fixed. The decimal point is the data separator. 


Delimiters 
“APOST and “QUOTE are mutually exclusive COBOL precompiler options that 
name the string delimiter within COBOL statements. *“APOST names the 
apostrophe (') as the string delimiter, "QUOTE names the quotation mark ("). 
*"APOSTSQL and *QUOTESQL are mutually exclusive COBOL precompiler options 
that play a similar role for SQL statements embedded in COBOL programs. 
"“APOSTSQL names the apostrophe (') as the SQL string delimiter; with this option, 
the quotation mark (") is the SQL escape character. “"QUOTESQL names the 
quotation mark as the SQL string delimiter; then the apostrophe is the SQL escape 
character. The values of *“APOSTSQL and *"QUOTESQL are, respectively, the same 
as the values of “APOST and “QUOTE. 


In host languages other than COBOL, the usages are fixed. The string delimiter for 
the host language and for static SQL statements is the apostrophe ('): the SQL 
escape character is the quotation mark ("). 


Special Registers 


A special register is a storage area whose primary use is to store information 
produced with the use of specific features of the data base manager. The following 
special register is implemented on the AS/400 system: 
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USER 
 & The USER special register is 8 characters in length; it specifies the run-time 
authorization ID. Thus, if you execute SQL statements interactively, USER 
specifies your user profile name. USER is padded on the right with blanks, if 
necessary, so that the value of USER is always a fixed-length character string of 
length 8. The value in USER cannot be changed. 


Here is an example of the use of USER: 
SELECT * FROM SYSIBM.SYSTABLES 


Column Names 


WHERE CREATOR = USER 


The meaning of a column name depends on its context. A column name can be 
used to: 


e Declare the name of a column, as in a CREATE TABLE statement. 


Identify a column, as in a CREATE INDEX statement. 


e Specify values of the column, as in the following contexts: 


In column functions, a column name specifies all values of the column in 
the group or intermediate result table to which the function is applied. 
(Groups and intermediate result tables are explained under “SELECT 
INTO” on page 109.) For example, MAX(SALARY) applies the function 
MAX to al! values of the column SALARY in a group. 


In GROUP BY or ORDER BY clauses, a column name specifies all values in 
the intermediate result table to which the clause is applied. For example, 
ORDER BY DEPT orders an intermediate result table by the values of the 
column DEPT. 


In expressions, search conditions, or scalar functions, a column name 
specifies a value for each row or group to which the expression or search 
condition is applied. For example, when the search condition CODE = 20 
is applied to some row, the value specified by the column name CODE is 
the value of the column CODE in that row. 


Qualified Column Names 
Whether a column name may be qualified depends, like its meaning, on its context: 


In some forms of the COMMENT ON and LABEL ON statements, a column 
name must be qualified. This is shown in the syntax diagrams. 


Where the column name specifies values of the column, it may be qualified at 
the user’s option. 


In all other contexts, a column name must not be qualified. 


Where a qualifier is optional, it can serve as acorrelation, as described under 
“Column Name Qualifiers to Avoid Ambiguity” on page 20. 


© 
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Correlation Names 


A correlation name can be defined in the FROM clause of a query and in the first 
clause of an UPDATE or DELETE statement. For example, the clause FROM 
X.MYTABLE Z establishes Z as a correlation name for X.MYTABLE. 


With Z defined as a correlation name for X.MYTABLE, only Z can be used to qualify 
a reference to a column of X.MYTABLE in that statement. 


A correlation name is associated with a table or view only within the context in 
which it is defined. Hence, the same correlation name can be defined for different 
purposes in different statements. 


If a correlation name is not specified, aname that is the same as the table or view 
name is implicitly assigned. If SQL naming is specified, the implicit correlation 
name is the qualified table name after any implicit qualification. If system naming 
is specified and the table name is qualified, the implicit correlation name is the 
table name portion of the qualified name. No two correlation names, whether 
implicitly or explicitly assigned, may be the same. Thus, while a correlation name 
may be the same as the name of another table, the other table cannot be 
referenced in the same statement unless a different correlation name has been 
assigned to it. 


As a qualifier, a correlation name can be used to avoid ambiguity or to establish a 
correlated reference. It can also be used merely as a shorter name for a table or 
view. Inthe example, “Z" might have been used merely to avoid having to enter 
X.MYTABLE more than once. 


Column Name Qualifiers to Avoid Ambiguity 
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In the context of a function, a GROUP BY or ORDER BY clause, an expression, ora 
search condition, a column name refers to values of a column in some table or 
view. The tables and views that might contain the column are called the object 
tables of the context. Two or more object tables might contain columns with the 
same name; one reason for qualifying a column name is to designate from which 
table the column comes. 


Table Designators: A qualifier that designates a specific object table is called a 
table designator. The clause that identifies the object tables also establishes the 
table designators for them. For example, the object tables of an expression in a 
SELECT clause are named in the FROM clause that follows it, as in this partial 
statement: 


SELECT Z.CODE, MYTABLE.CODE 
FROM MYTABLE Z, MYTABLE 
WHERE ... 


This example illustrates how to establish table designators in the FROM clause: 


1. Aname that follows a table or view name is a correlation name and atable 
designator. So Z is a table designator, and qualifies the first column name 
after SELECT. 


2. A table name or view name that is not followed by a correlation name is a 
table designator. So MYTABLE is a designator, and qualifies the second 
column name after SELECT. 


os 


S| 


Host Variables 


Avoiding undefined or ambiguous references: When a column name refers to 
values of a column, exactly one object table must include a column with that name. 
The following situations are considered errors: 


e No object table contains a column with the specified name. The reference is 
undefined. 

e The column name is qualified by a table designator, but the table designated 
does not include a column with the specified name. Again the reference is 
undefined. 

e The name is unqualified, and more than one object table includes a column 
with that name. The reference is ambiguous. 


Avoid ambiguous references by qualifying a column name with a uniquely defined 
table designator. If the column is contained in several object tables with different 
names, the table names can be used as designators. 


Two or more object tables can be instances of the same table. In this case, distinct 
correlation names must be used to unambiguously designate the particular 
instances of the table. In the following FROM clause, for example, X and Y are 
defined to refer, respectively, to the first and second instances of table 
CORPDATA.TEMPL. 


FROM CORPDATA.TEMPL X, CORPDATA.TEMPL Y 


A host variable is a PL/I or RPG variable, or a COBOL group data item, that is 
referenced in an SQL statement. Host variables can only be referenced in static 
SQL statements. Host variables should not begin with the characters 'SQL' or 
'RDI'. Host variables are defined by statements of the host language. 


The term host-variable, as used in the syntax diagrams, shows a reference toa 
host variable. A host-variable in the INTO clause of a FETCH or SELECT INTO 
statement identifies a host-variable to which a value from a column of a row is 
assigned. In all other contexts, a host variable specifies a value. 


The general form of a host variable reference is: 
:host-identi fier: host-identi fier 


The variable designated by the second host-identifier must have a data type of 
small integer with zero scale. 


The first host identifier designates the main variable; the second host identifier 
designates its indicator variable. One purpose of the indicator variable is to 
specify the null value. A negative value in the indicator variable specifies the null 
value. 


For example, if :V1:V2 is specified in a FETCH or SELECT INTO statement, and if 
the value returned is null, V1 is not changed, and V2 is set to a negative value, 
either to -1, if the value selected was the null value, or to -2, if the null value was 
returned because of numeric conversion errors or arithmetic expression errors 
met in the SELECT list of an outer SELECT statement. If the value returned is not 
null, that value is assigned to V1, and V2 is set to zero (unless the assignment to V1 
requires string truncation, in which case V2 is set to the original length of the 
string). If an indicator variable used in other than a FETCH statement or an INTO 
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clause contains a negative value, a negative value is returned in the SQLCODE 
field of the SQLCA. ) 


Another form of host variable reference is: 


:host-identi fier 


lf this form is used, the host variable does not have an indicator variable. The 
value specified by the host variable reference :V1 is always the value of V1, and 
null values cannot be assigned to the variable. Thus, this form should not be used 
in an INTO clause unless the corresponding column cannot contain null values. 


lf a null value is returned, and you have not provided an indicator variable, a 
negative value is returned in the SQLCODE field of the SQLCA. If your data is 
truncated and there is no indicator variable, no error condition results. 


A host variable must always be preceded by a colon when it is used in an SQL 
statement. 


In PL/I, an SQL statement that references host variables must be within the scope 
of the declaration of those host variables. For host variables referenced in the 
SELECT statement of a cursor, this rule applies to the OPEN statement rather than 
to the DECLARE CURSOR statement. 


Host Structures in COBOL, PL/I, and RPG 
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A host structure is a COBOL group, PL/I structure, or RPG data structure thatis 

referenced in an SQL statement. Host structures are defined by statements of the 

host language, as explained in the Programming: Structured Query Language Za 
Programmer's Guide. As used here, the term “host structure” does not include an 

SQLCA or SQLDA. 


The form of a host structure reference is identical to the form of a host variable 
reference. The reference :S1:S2 is a host structure reference if S1 designates a 
host structure. If S2 designates a host structure. it must be defined as a vector of 
small integer variables. S1 is the main structure and S2 is its indicator structure. 


A host structure may be referenced in any context where a list of host variables 
may be referenced. A host structure reference is equivalent to a reference to each 
of the host variables contained within the structure in the order which they are 
defined in the host language structure declaration. The nth variable of the 
indicator structure is the indicator variable for the nth variable of the main 
structure. 


In COBOL, for example, if V1, V2, and V3 are declared as variables within the 
structure S1, the statement: 


EXEC SQL FETCH CURSORI INTO :S1 END-EXEC. 


is equivalent to: 
EXEC SQL FETCH CURSOR1 INTO :V1, :V2, :V3 END-EXEC. 


If the main structure has m more variables than the indicator structure, the last m 

variables of the main structure do not have indicator variables. If the main 

structure has rn less variables than the indicator structure, the last m variables of : 
the indicator structure are ignored. These rules also apply if a reference to a host S| 
structure includes an indicator variable or if a reference to a host variable includes 


an indicator structure. If an indicator structure or variable is not specified, no 
variable of the main structure has an indicator variable. 


In addition to structure references, individual host variables or indicator variables 
in PL/I] and COBOL may be referenced by qualified names. The qualified form is a 
host identifier followed by a period and another host identifier. The first host 
identifier must designate a structure, and the second host identifier must designate 
a host variable within that structure. The qualified form of host variable names is 
not allowed in RPG. 


The following diagram specifies the syntax of references to host variables and host 
structures: 


se. 


L_host-identifier.— 


ij Ee 


> hos t-identi fier 


ere fier. 


Expressions 


An expression specifies a value. The form of an expression is as follows: 


function 

ee, Scanner, 
constant 
column—name 


+t 
ee ee 
special—register 


Without Operators 


lf no operators are used, the result of the expression is the specified value. Here 
are four examples of such expressions: 


SALARY : SALARY ‘SALARY! MAX (SALARY ) 
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With the Concatenation Operator 
If the concatenation operator (||) is used, the result of the expression is a string. 
The operands of concatenation must both be the result of an expression, and both 
must be character strings. The sum of their lengths must not exceed 32,766. The 
concatenation operator cannot be used in dynamic SQL. 


lf either operand can be null, the result can be null, and if either is null, the result 
is the null value. Otherwise, the result consists of the first operand string followed 
by the second. With mixed data this result will not have redundant shift codes “at 
the seam.” Thus, if the first operand is a string ending with a “shift-in” character 
(X’OF’), while the second operand is a character string beginning with a “shift-out” 
character (X’0E’), these two bytes are eliminated from the result. 


Here is an example of an expression containing this operator: 


FIRSTNME||' '| |LASTNAME 


With Arithmetic Operators 
lf arithmetic operators are used, the result of the expression is a number derived 
from the application of the operators to the values of the operands. If any operand 
can be null, or the expression is used in an outer SELECT list, the result can be the 
null value. If any operand has the null value, the result of the expression is the null 
value. Arithmetic operators must not be applied to character strings. Thus, for 
example, USER +2 is invalid. 


The prefix operator + (unary plus) does not change its operand. The prefix 

operator - (unary minus) reverses the sign of a non-zero operand; and if the data 

type of A is “small integer,” then the data type of -A is “large integer.” The first 2 
character of the token following a prefix operator must not be a plus or minus sign. 


The infix operators +, -, *, and / specify addition, subtraction, multiplication, and 
division, respectively. The value of the second operand of division must not be 
zero. 


Two Integer Operands 
If both operands of an arithmetic operator are integers with zero scale, the 
operation is performed in binary, and the result is a large integer. Any remainder 
of division is lost. The result of a binary arithmetic operation (including unary 
minus) must be within the range of large integers. If either integer operand has 
non-zero scale, it is converted to a decimal operand with the same precision and 
scale. 


Integer and Decimal or Numeric Operands 
If one operand is an integer with zero scale and the other is decimal or numeric, 
the operation is performed in decimal using a temporary copy of the integer which 
has been converted to a decimal number with zero scale and precision as defined 
in the following table: 
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Column or variable: large integer 


Column or variable: small integer 


Constant (including leading zeros) same as the number of 
digits in the constant 


If one operand is an integer with non-zero scale, it is first converted to a decimal 
operand with the same precision and scale. 


Two Decimal or Numeric Operands 
If both operands are decimal or numeric, the operation is performed in decimal. 
The result of any decimal arithmetic operation is a decimal number with a 
precision and scale that are dependent on the operation and the precision and 
scale of the operands. If the operation is addition or subtraction and the operands 
do not have the same scale, the operation is performed with a temporary copy of 
one of the operands that has been extended with trailing zeros so that its fractional 
part has the same number of digits as the other operand. 


The result of a decimal operation must not have a precision greater than 31. The 
result of decimal addition, subtraction, and multiplication is derived from a 
temporary result, which may have a precision greater than 31. If the precision of 
the temporary result is not greater than 31, the final result ts the same as the 
temporary result. If the precision of the temporary result is greater than 31, the 
final result is derived from the temporary result by the elimination of leading zeros 
so the final result has a precision of 31. 


Decimal Arithmetic in SQL 
The following formulas define the precision and scale of the result of decimal 
operations in SQL. The symbols p and s denote the precision and scale of the first 
operand and the symbols p' and s' denote the precision and scale of the second 
operand. 


The precision of the result of addition and subtraction is 
min(31, max(p-s, p'-s') + max(s, S') +1) and the scale is max(s, $s‘). 


The precision of the result of multiplication is min(31, p+p') and the scale is 
min(31,s+s'). 


The precision of the result of division is 31 and the scale is 31-p+s-s'. If the scale 
is negative, a negative value is returned in the SQLCODE field of the SQLCA. 


Floating-Point Operands 
lf either operand of an arithmetic operator is floating-point, the operation is 
performed in floating-point, the operands having first been converted to double 
precision floating-point numbers, if necessary. Thus, if any element of an 
expression is a floating-point number, the result of the expression is a double 
precision floating-point number. 


An operation involving a floating-point number and an integer is performed with a 


temporary copy of the integer, which has been converted to double precision 
floating-point. An operation involving a floating-point number and a decimal or 
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numeric number is performed with a temporary copy of the decimal or numeric 
number, which has been converted to double precision floating-point. The result of JD 
a floating-point operation must be within the range of floating-point numbers. 


Precedence of Operations 
Expressions within parentheses are evaluated first, and, when the order of 
evaluation is not specified by parentheses, prefix operators are applied before 
multiplication and division; multiplication and division are applied before addition 
and subtraction, and operators at the same precedence level are applied from left 
to right. 


Here are three examples of expressions: 
PRSTAFF + 1 (SALARY + BONUS) * 1.10 SALARY /: VAR3 


Host Variables 
A host variable in an expression must identify a host variable (not a structure) 
described in the program according to the rules for declaring host variables. For 
further information about declaring host variables, see Programming: Structured 
Query Language Programmer’s Guide. 


Predicates 


A predicate specifies a condition that is “true,” “false,” or “unknown” about a 
given row or group. 


The general form of a predicate is as follows: 2 


et 


a ae ae expression AND al 
NOT 


USER 
col ae ane a host-variable 
NOT tression———— 


soos ae (eran Tey 
he host—variable . 
Flees opeane 


— ae “> a ————_——_ 
< 


L_yseR—__—_—_| 
All values specified in a predicate must be compatible. The value of a host 
variable must not be a string longer than 32766 bytes. The value of a host variable 7 ) 


must not be null (that is, the variable may not have a negative indicator variable). 
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A view column referenced in a predicate must not be derived from a column 
function unless it is used in a HAVING clause. 


Basic Predicate 
A basic predicate is used to compare two values. The format of a basic predicate 


is an expression followed by a comparison operator and another expression. 


If the value of either operand is null, the result of the predicate ts unknown. 
Otherwise, the result is either true or false. 


For values x and y: 


Predicate Is True If and Only ff... 
x=y x is equal toy 

x7= y x is not equal toy 

x<> y x is not equal toy 

x <y x is less than y 

x>y xX is greater than y 

x<= y x is less than or equal toy 
X>= y x is greater than or equal to y 
x7< y x is not less than y 

x-> y x is not greater than y 
Examples: 


EMPNO = '528671' 
SALARY < 20000 
PRSTAFF <>: VAR1 


BETWEEN Predicate 


The BETWEEN predicate is used to compare a value with a range of values. The 
format of a BETWEEN predicate is as follows: 


>——expressi ee A (a on——AND——express 1 on——_____LL_> 
NOT 


The BETWEEN predicate: 
value-1 BETWEEN value-2 AND value-3 


is equivalent to the search condition: 


value-l >= value-2 AND value-l <= value-3 


The BETWEEN predicate: 
value-1 NOT BETWEEN value-2 AND value-3 


is equivalent to the search condition: 
NOT(value-1 BETWEEN value-2 AND value-3) 


Example: SALARY BETWEEN 20000 AND 40000 
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LIKE Predicate 


The LIKE predicate is used to search for strings that have a certain pattern. The wD 
pattern is specified by a string in which the underscore and percent sign have 
special meanings. The format of the LIKE predicate is as follows: 


USER 
——columi=nane == IRE sees ig ee 


L__jo7—— L_§_string-constant—— 
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The column-name must identify a string column. If a host variable is specified, it 
must identify a character variable (not a structure) that is described in the program 
under the rules for declaring string host variables; it cannot have an indicator 
variable. 


This predicate is best explained by examples. The following description is 
intended for those who require a rigorous definition. The description uses x to 
denote a value of the column and y to denote the string specified by the second 
operand. The terms “character,” “percent sign,” and “underscore” in the 
following discussion refer to EBCDIC characters. 


The string y is interpreted as a sequence of the minimum number of substring 
specifiers so each character of y ts part of exactly one substring specifier. A 
substring specifier is an underscore, a percent sign, or any nonempty sequence of 
characters other than an underscore or a percent sign. 


The result of the predicate is either true or false. The result is true if there exists a wa 
partitioning of x into substrings such that: 


e A substring of x is a sequence of zero or more contiguous characters and each 
character of x is part of exactly one substring. 


e If the nth substring specifier is an underscore, the nth substring of x is any 
single character. 


e If the nth substring specifier is a percent sign, the nth substring of x is any 
sequence of zero or more characters. 


e lf the nth substring specifier is neither an underscore nor a percent sign, the 
nth substring of x is equal to that substring specifier and has the same length 
as that substring specifier. 


e The number of substrings of x is the same as the number of substring 
specifiers. 


The predicate x NOT LIKE y is equivalent to the search condition \OT(x LIKE y). 


If a host variable is specified, it must be of the form :host-variable. The form 
:host-variable:host-indicator is not allowed. 


With Mixed Data: If the column identified by co/umn-name allows mixed data, the 
column may contain double-byte characters, as may the host variable or string 
constant. In that case, the special characters in y are interpreted as follows: 


e An EBCDIC underscore refers to one EBCDIC character; a double-byte i P 
underscore refers to one double-byte character. 


e A percent sign, either EBCDIC or double-byte, refers to any number of 
characters of any type, either EBCDIC or double-byte. 


Examples: 


NAHE LIKE '%SMITH%! 
STATUS LIKE 'N ! 


The first example is true if 'SMITH' appears anywhere within NAME. The second 
example is true if the value of STATUS has a length of two and the first character is 


oN, 


IN Predicate 


The IN predicate is used to compare a value with a collection of values. The format 
of the IN predicate is as follows: 


ea cs aa Ls expression 
NOT | = | 
host-va 


7 
able) 
2 Se eae 
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Each host variable specified must identify a structure or variable that is described 
in the program under the rules for declaring host structures and variables. An 
indicator variable must not be included. 


If a host variable is specified, it must be of the form :host-variable. The form 
shost-variable:host-identifier is not allowed. 


An IN predicate of the form: 
expression IN expression 
is equivalent to a basic predicate of the form: 
expression = expression 
In the other form of the IN predicate, the second operand is a collection of one or 


more values specified by any combination of host variables, constants, or the 
keyword USER. 


Example: 
DEPTNO IN ('DQ1', 'BO1', 'CO1') 


Search Conditions 


A search condition specifies a condition that is “true,” “false,” or “unknown” about 
a given row or group. The form of a search condition is as follows: 
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Dea pre 
(search—condition) 


The result of a search condition is derived by the application of the specified 
Boolean operators to the result of each specified predicate. If Boolean operators 
are not specified, the result of the search condition is the result of the specified 
predicate. 


Examples: 


SALARY > 20000 
NAME LIKE :VAR4 
AVG(SALARY) < 30000 


NOT(true) is false, NOT(false) is true, and NOT(unknown) is unknown. AND and OR 
are defined in Figure 1, in which P and Q are any predicates: 


True False False True 


| True | Unknown | Unknown | True | 


Unknown True Unknown True 


| Unknown | False | False | Unknown | 


Figure 1. Truth Tables for AND and OR 


Boolean expressions within parentheses are evaluated first and, when the order of 
evaluation is not specified by parentheses, NOT is applied before AND, and AND is 
applied before OR. The order in which operators at the same precedence level are 
evaluated is undefined to allow for optimization of search conditions. 


Example: 
MAJPROJ = 'MA2100' AND (DEPTNO = 'D11' OR DEPTNO = 'BO3') 


C 
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A function is an operation denoted by a function name followed by a pair of 
parentheses enclosing the specification of one or more operands. The operands of 
functions are called arguments. Most functions have a single argument that is 
specified by an expression. The result of a function is a single value derived by the 
application of the function to the result of the expression. 


Functions are classified as scalar functions or column functions. The argument of 
a column function is a collection of values. An argument of a scalar function is a 
single value. 


In the syntax of SQL, the only use of the term “function” is in the definition of an 
expression. Thus, a function can be used only where an expression can be used. 
Additional restrictions apply to the use of column functions as specified below and 
under Chapter 4, “Queries” on page 39. 


Column Functions 


AVG 


The argument of COUNT(*) is a group or an intermediate result table as explained 
In the description of the SELECT statement. The following applies to all column 
functions other than COUNT(*). 


The argument of a column function is a collection of values derived from one or 
more columns. The scope of the collection is a group or an intermediate result 
table as explained in the description of the SELECT statement. For example, the 
result of the following SELECT statement is the number of employees in 
department D01: 


SELECT COUNT(*) 
FROM CORPDATA. TEMPL 
WHERE WORKDEPT = 'DO1' 


The values of the argument are specified by an expression. This expression must 
not include a column function, and must include at least one column-name, a 
requirement that is not satisfied by a reference to a view column derived from a 
constant or expression without a column name. 


Following, in alphabetical order, is a definition of each of the column functions. 


The AVG function is used to obtain the average of a collection of numbers. The 
form of the function is: 


—— ANG ee ee — gene eee ae 
ALL 


The argument values must be numbers and their sum must be within the range of 
the data type of the result. 
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The data type of the result is the same as the data type of the argument values, 
except that the result is double precision floating-point if the argument values are 
single precision floating-point, and the result is decimal if the argument values are 
non-zero scale binary. If the data type of the argument values is decimal or 
non-zero scale binary with precision p and scale s, the precision of the result is 31 
and the scale is 31-p +s. The result can be null. 


The function is applied to the collection of values derived from the argument 


values. If this collection is empty, the result of the function is the null value. 
Otherwise, the result is the average value in the collection. 


Example: AVG(SALARY) 


COUNT 


The COUNT function is used to obtain the ordinality of a collection of rows or 
values. The form of the function is: 


> COUNT (1) a 


The argument of COUNT({*) is a collection of rows, and the result is the number of 
rows in the collection. 


MAX 
The MAX function is used to obtain the maximum value in a collection of values. 
The form of the function is: 


———— AK Sas rong ics aca) SS 


ALL 


The argument values can be any values other than character strings whose 
maximum length is greater than 256. 


The data type and length attribute of the result are the same as the data type and 
length attribute of the argument values. The result can be null. 


The function is applied to the collection of values derived from the argument 
values. If this collection is empty, the result of the function is the null value. 


Otherwise, the result is the maximum value in the collection. 


Example: MAX(SALARY) 
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The MIN function is used to obtain the minimum value in a collection of values. 
The form of the function is: 


>—_____MIN So oe 


ALL 


The argument values can be any values other than character strings whose 
maximum length is greater than 256. 


The data type and length attribute of the result are the same as the data type and 
length attribute of the argument values. The result can be null. 


The function is applied to the collection of values derived from the argument 
values. If this collection is empty, the result of the function is the null value. 
Otherwise, the result is the minimum value in the collection. 


Example: MIN(SALARY) 


SUM 


The SUM function is used to obtain the sum of a collection of numbers. The form of 
the function is: 


>——_—_——SUM ieee ee 0) SS 
ALL 


The argument values must be numbers and their sum must be within the range of 
the data type of the result. 


The data type of the result is the same as the data type of the argument values 
except that the result is double precision floating-point if the argument values are 
single precision floating-point, large integers if the argument values are small 
integers, and decimal if the argument values are non-zero scale binary. Ifthe data 
type of the argument values is numeric, decimal, or non-zero scale binary, the 
precision of the result is 31 and the scale is the same as the scale of the argument 
values. The result can be null. 


The function is applied to the collection of values derived from the argument 
values. If this collection is empty, the result of the function is the nul! value. 


Otherwise, the result is the sum of the values in the collection. 


Example: SUM(SALARY) 


Chapter 3. Functions 33 


Scalar Functions J 


A scalar function can be used wherever an expression can be used. The 
restrictions on the use of column functions do not apply to scalar functions. For 
example, the argument of a scalar function can be a function. However, the 
restrictions that apply to the use of expressions and column functions also apply 
when an expression or column function is used within a scalar function. For 
example, the argument of a scalar function can be a column function only if a 
column function is allowed in the context in which the scalar function is used. 


The restrictions on the use of column functions do not apply to scalar functions 
because a scalar function is applied to a single value rather than a collection of 
values. For example, the result of the following SELECT statement has as many 
rows as there are employees in department D01: 


SELECT EMPNO, LASTNAME, SUBSTR(FIRSTNME, 1, 1) 
FROM CORPDATA. EMP 
WHERE WORKDEPT = 'DQ1' 


Foliowing in alphabetical order is the definition of each of the scalar functions. 


DECIMAL 
The DECIMAL function is used to obtain a packed decimal representation of a 
numeric value. The form of the function is: 


>————DECIMAL (expression )— YN 
,intege 


The first argument must be anumber. The second argument , if specified, must be 
in the range of 1 to 31. The third argument , if specified, must be in the range of 0 
to p, where p is the second argument. Omission of the third argument is an implicit 
specification of zero. 


The default for the second argument depends on the data type of the first 
argument: 


e 15 for floating-point, decimal, numeric, or non-zero scale binary 
e 11 for large integer 
e 5 for small integer 


The result of the function is a decimal number with precision of p and scale of s, 
where p and Ss are the second and third arguments. 


The result is the same number that would occur if the first argument were assigned 
to a decimal column or variable with a precision of p and a scale of s. An error 


occurs if the number of significant decimal digits required to represent the whole 
part of the number is greater than p-s. 


Example: DECIMAL(AVG(SALARY) ,8,2) c ) 
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DIGITS 
c The DIGITS function is used to obtain a character string representation of a 
number. The form of the function is: 


Pe ICUS lexi 0eS 6 0n) =e SSS SSS SS SS 


The argument must be an integer, decimal, or numeric value. 
The result of the function is a fixed-length character string. 


The result is a string of digits that represents the absolute value of the argument 
without regard to its scale. Thus, the result does not include a sign or a decimal 
point. The result includes any necessary leading zeros so that the length of the 

string is: 


e 5 if the argument is a small zero scale integer 

e 10 if the argument is a large zero scale integer 

e pifthe argument is a decimal, numeric, or non-zero scale integer with a 
precision of p. 


Example: DIGITS(JOBCODE) = '6' 


FLOAT 
Yom The FLOAT function is used to obtain a floating-point representation of a number. 
The form of the function is: 


= LOA eipress 00) 


The argument must be a number. 
The result of the function is a double precision floating-point number. 


The result is the same number that would occur if the argument were assigned to a 
double precision floating-point column or variable. 


Example: FLOAT(ACSTAFF) /2 
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INTEGER 
The INTEGER function is used to obtain an integer representation of a number. ; 
The form of the function is: 


EGER (@XDl ess 100 |) SS SSS 


The argument must be a number. 

The result of the function is a large integer with zero scale. 

The result is the same number that would occur if the argument were assigned to a 
large integer column or variable. If the whole part of the argument is not within the 


range of integers, a negative value is returned in the SQLCODE field of the SQLCA. 


Example: INTEGER(SUM(EMPTIME)+.5) 


LENGTH 


The LENGTH function is used to obtain the length of a value. The form of the 
function is: 


>_—_——LENGTH (expression) : 


The argument can be any value. 
The result of the function is a large integer with zero scale. 


The result is the length of the argument. The length is the number of bytes used to 
represent the value: 


the length of the string, for character strings 

2 for small integer 

4 for large integer 

4 for single precision floating-point 

8 for double precision floating-point 

INTEGER(p/2) +1 for decimal numbers with precision p 
p for numeric numbers with precision p 


Example: LENGTH(STRING)—:N 
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C SUBSTR 


The SUBSTR function obtains a substring of astring. The form of the function is: 


»>——-SUBSTR (expression, Rea ee eee 


, integer 


In the following description of the SUBSTR function, string, start, and /ength are 
used to denote its first, second, and third arguments. 


string must be a string, and start must be an integer between ‘1 to the length of 
string. start specifies the first character of the result and /ength specifies the 
length of the result. 


A substring of string is one or more contiguous characters of string. The SUBSTR 
function does not recognize mixed data, so if string contains mixed data, the result 
may not be a well-formed mixed data string. 


length, if specified, must be an integer from 1 to n, where n equals the length of 
String - start + 1. Omission of /ength is an implicit specification of 


LENGTH(string)-start+ 1. The default for /ength is the number of characters from 
the character specified by sfarf to the last character of string. 


Example: SUBSTR(FIRSTNAME, 1,1) 


O 
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Chapter 4. Queries 


Authorization 


subselect 


A query specifies a result table or intermediate result table. 


In a program, a query is a component of other SQL statements. The three forms of 
the query described here are: 


e The subselect, 
e The fullselect, and 
e The select-statement 


Note that there is another form of select, as described under “SELECT INTO” on 
page 109. 


Note: Where the syntax outlined in these descriptions is specifically limited to a 
column-name, (rather than to an expression), the column you identify must not be a 
column of a view derived from an expression, function, or constant. 


For any form of the query, the privileges held by the authorization ID of the 
statement must include the SELECT privilege on every table and view identified in 
the statement. 


You have the SELECT privilege on a table if any of the following apply: 


e You are the owner of the table. 

e You have been granted the SELECT privilege on the table. 

e You have been granted the system authorities “"OBJOPR and “READ on the 
table. 


You have the SELECT privilege on a view if any of the following apply: 


e You have been granted the SELECT privilege on the view. 

e You created the view, you had the SELECT privilege on its base table when the 
view was Created, and you still have that SELECT privilege. 

e You have been granted the system authority “OBJOPR on the view and the 
system authority “READ on the base table. 


>—select-c]lause—from-cl Br We scocedecane ol oe acetates I (ocak 
where-clause group-by-clause having-clause— 


The subselect is a component of the fullselect, the CREATE VIEW statement, and 
the INSERT statement. It is also a component of certain predicates which, in turn, 
are components of a subselect. 


A subselect specifies a result table derived from the tables or views identified in 


the FROM clause. The derivation can be described as a sequence of operations in 
which the result of each operation is input for the next. (This is only a way of 
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select-clause 
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describing the subselect. The method used to perform the derivation may be quite 
different from this description.) ‘ ; 


The sequence of the (hypothetical) operations is: 


. FROM clause 

. WHERE clause 

. GROUP BY clause 
. HAVING clause 

. SELECT clause 


on & G A — 


correlation-name 


Produces a final result table by selecting only the columns indicated by the se/ect 
list from R, where R is the result of the previous clause. 


ALL 

Retains all rows of the final result table, and does not eliminate redundant 

duplicates. This is the default. wd 
DISTINCT 


Eliminates all but one of each set of duplicate rows of the final result table. 
DISTINCT must not be used more than once in a subselect. 


Two rows are duplicates of one another only if each value in the first is equal 
to the corresponding value of the second. 


Select List Notation 


* 


Represents a list of names that identify the columns of table R. The first name 
in the list identifies the first column of R, the second name identifies the 
second column of R, and so forth. The list is established when the program is 
prepared and does not represent any columns that have been added to the 
table later. 


name." 
Represents a list of names that identify the columns of name. name may be a 
table name, view name, or correlation name. and must designate a table or 
view named in the FROM clause, but must not be of the form 
data-base/table-name. The first name in the list identifies the first column of 
name, the second name identifies the second column, and so forth. The list is 
established when the program is prepared and does not represent any 
columns that have been added to the table later. 


expression 
May be any expression of the type described in Chapter 2, but commonly the ys 
expressions used include column names. Each column name used in the ‘2 
select list must unambiguously identify a column of R. 


The number of columns in the result of SELECT is the same as the number of 
expressions in the operational form of the select list (that is, the list established at 
prepare time), and may not exceed 8000. 


Other Limitations: The select list must not include column functions if R is derived 
from a view whose subselect includes DISTINCT, GROUP BY, or HAVING. 
Furthermore, if R is derived from a view whose subselect includes DISTINCT, the 
select list must identify all columns of the view (possibly by SELECT *) and must 
not include DISTINCT or arithmetic expressions. 


Applying the Select List: Some of the results of applying the select list to R depend 
on whether or not GROUP BY or HAVING is used. We describe those results 
separately. 


If neither GROUP BY nor HAVING ts used: 


e The select list must not include any column functions, or it must be entirely a 
list of column functions. 


e Ifthe select does not include column functions, then the select list is applied to 
each row of R, and the result contains as many rows as there are rows inR. 


e |f the select listis a list of column functions, then R is the source of the 
arguments of the functions, and the result of applying the select list is one row. 


If GROUP BY or HAVING ts used: 


e Each colfumn-name in the select list must either identify a grouping column or 
be specified within a column function. 


e The select list is applied to each group of R, and the result contains as many 
rows as there are groups in R. When the select list is applied to a group of R, 
that group is the source of the arguments of the column functions in the select 
list. 


In either case, the nth column of the result contains the values specified by 
applying the nth expression in the operational form of the select list. 


Null attributes of result columns: Result columns do not allow null values if they 
are derived from: 


e A column 

e A constant 

e The COUNT function 

e A host variable 

e A scalar function or expression that does not allow null values. 


Result columns do allow null values if they are derived from: 


e Any column function but COUNT 
e An arithmetic expression 
e A scalar function that allows null values. 


Names of result columns: A result column derived from a column name acquires 
the unqualified name of that column. All other result columns have no names. 


Data types of result columns: Each column of the result of SELECT acquires a data 
type from the expression from which it is derived. 
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from-clause 
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When the The data type 
expression is ... of the result column is ... 


the name of any the same as the data type of the column, with the same 
numeric column precision and scale for decima!, numeric, or binary 
columns. 


an integer INTEGER 
constant 


the same as the data type of the constant, with the same 
precision and scale for decimal constants. For 
floating-point constants, the data type is double 
precision. 


a decimal or 
floating-point 
constant 


the same as the data type of the variable, with the same 
precision and scale for decimal, numeric, or binary 
variables. 


the name of any 
numeric variable 


the same as the data type of the result, with the same 
precision and scale for numeric results as described 
under “Expressions” on page 23. 


an arithmetic 
expression 


See Chapter 3 to determine the data type of the result. 
the name of any the same as the data type of the column, with the same 
string column length attribute. 
the name of any the same as the data type of the variable, with a length 
string variable attribute equal to the length of the variable. 


a Character string Variable length of length n. 


constant of length 
n 


| 
>——FRO tabl ee ee See 
aia et 7ew-name corre lation—name 


Names a single table or view, or produces an intermediate result table. The 
intermediate result table contains all possible combinations of the rows of the 
named tables or views. Each row of the result is a row from the first table or view 
concatenated with a row from the second table or view, concatenated in turn with a 
row from the third, and soon. The number of rows in the result is the product of 
the number of rows in all the named tables or views. 


The list of names in the FROM clause must conform to these rules: 


e Each table-name and view-name must name a table or view described in the 
data base. 


c 


C 


e |f the FROM clause specifies a view that contains a GROUP BY, HAVING, or 
DISTINCT clause, no other tables or views can be specified in that FROM 
clause. 


The FROM clause also defines the meaning of correlation names. A 
correlation-name applies to the table or view named by the immediately preceding 
table-name or view-name. If a correlation name is specified, then that correlation 
name must be used elsewhere in the subselect statement to designate that table or 
view. For rules governing the use of correlation names, see “Qualified Column 
Names” on page 19. 


Each correlation name specified in the same FROM clause must be unique and 
must not be the same as a table name or view name specified in the clause. When 
the same table name or view name is specified more than once in a FROM clause, 
a correlation name must be specified after each occurrence of the replicated name. 
lf a correlation name is specified for a table or view, any qualified reference to a 
column of that table or view in the subselect must use that correlation name. 


where-clause 


WHERE Search 6 60 a SS 


Produces an intermediate result table by applying search-condition to each row of 
R, where R is the result of the FROM clause. The result table contains the rows of 
R for which the search condition is true. 


search-condition describes a search condition that conforms to these rules: 
e The condition is formed as described in Chapter 2. 


e Each column-name in the search condition unambiguously identifies a column 
of R. 


e A column-name inthe search condition does not identify a column that is 
derived from a column function. (A column of a view can be derived from a 
column function.) 


group-by-clause 


>——GROUP BY ee 


Produces an intermediate result table by grouping the rows of R, where R is the 
result of the previous clause. 


column-name unambiguously names a column of R. Each column named is called 
a grouping column. 
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The result of GROUP BY is a set of groups of rows. In each group of more than one 
row, all values of each grouping column are equal; and all rows with the same set a 
of values of the grouping columns are in the same group. 


Because every row of a group contains the same value of any grouping column, 
the name of a grouping column can be used in a search condition in a HAVING 
clause or an expression in a SELECT clause: in each case, the reference specifies 
only one value for each group. 


having-clause 


»>——HAVING search-condi t10n—_____TT——_ 


Produces an intermediate result table by applying search-condition to each group 
of R, where R is the result of the previous clause. If that clause is not GROUP BY, 
all rows of R are considered as one group. The result table contains those groups 
of R for which the search condition is true. 


search-condition describes a search condition that conforms to these rules: 
e The condition is formed as described in Chapter 2. 
e Each column-name in the search-condition must: 
— Unambiguously identify a grouping column of R, or J 


— Be specified within a column function.’ 


A group of R to which the search condition is applied supplies the argument for 
each function in the search condition. 


Examples of a subselect 
Example 1: Show all rows of CORPDATA.EMP. 


SELECT * FROM CORPDATA. EMP 


Example 2: Show the job code, maximum salary, and minimum salary for each 
group of rows of CORPDATA.EMP with the same job code, but only for groups with 
more than one row and with a maximum salary greater than $50,000. 


SELECT JOBCODE, MAX(SALARY), MIN(SALARY) 
FROM CORPDATA. EMP 
GROUP BY JOBCODE 
HAVING COUNT(*) > 1 AND MAX(SALARY) > 56000 


1 See Chapter 3, “Functions” on page 31 for restrictions that apply to the use of column 
functions. 
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Cc fullselect 


-————— UNION 


es ALL 


——_ 7 —_silpse lect 
—_(fullselect) — 


A fullselect specifies a result table. If UNION is not used, the result of the fullselect 
is the result of the specified subselect. 


UNION or UNION ALL 
Derives a result table by combining two other result tables (R1 and R2.). If 
UNION ALL is specified, the result consists of all rows in R1 and R2. If UNION 
is specified without the ALL option, the result is the set of all rows in either R1 
or R2, with duplicate rows eliminated. In either case, however, each row of the 
UNION table is either a row from R1 or a row from R2. The columns of the 
result are not named. 


Two rows are duplicates of one another only if each value in the first is equal to the 
corresponding value of the second. 


Note that the UNION ALL operation is associative, and that 


eS (SELECT PROJNO FROM CORPDATA. PROJ 
UNION ALL 
SELECT PROJNO FROM CORPDATA.TPROJEC) 
UNTON ALL 


SELECT PROJNO FROM CORPDATA.EMPPROJA 


will return the same results as 


SELECT PROJNO FROM CORPDATA. PROJ 
UNION ALL 

(SELECT PROJNO FROM CORPDATA. TPROJEC 
UiITON ALL 

SEL=CT PROJNO FROM CORPDATA.EMPPROJA) 


When you include the UNION ALL operator tn the same SQL statement as a UNION 
operator. however, the result of the operation depends on the order of evaluation. 
Where there are no parentheses, evaluation is from left to right. Where 
parentheses are included, the parenthesized subselect is evaluated first, followed. 
from left to right, by the other components of the statement. 


Rules for columns: 


R1 and R2 must have the same number of columns. The description of the first 
column of R1 must be compatible with the description of the first column of R2, the 
description of the second column of R1 must be compatible with the description of 
the second column of R2, and so on. 


In the following explanations, let Co/umn? denote the nth column of R1, Column2 


the nth column of R2, and Co/umn3 the nth column of the result of a UNION or 
LU UNION ALL. 
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e String Columns: Column3 will be a character string. If both Column? and 
Column2 are fixed-length, Co/umn3 will be fixed-length. Otherwise, Column3 
will be varying-length. In either case, the length attribute of Co/umn3 will be 
the greater of the length attributes of Column? and Column2. 


e Numeric Columns: Column? and Column2 must both be numeric. The 
following rules govern the data type of Co/umn3: 


— If Column? or Columna2 is floating-point, Column3 is floating-point. 

— If Column? or Column2 is double precision, Co/umn3 is double precision. 

— If Column? and Column2 are single precision, Columns? is single precision. 

— If Column? or Column2 is single precision, and the other is integer or 
decimal, Co/umn3 is double precision. 

— If Column? and Column2 are decimal, Co/umn3 is decimal. If p and s are 
the precision and scale of Co/umn1/, and p' and s' are the precision and 
scale of Column2, the precision of Column3 is MAX(s,s')+MAX(p-s,p'-s') 
and the scale of Co/umn3 is MAX{s.s'). The precision of Co/urnn3 must not 
be greater than 31. 

— If Column? and Column2 are numeric, Co/umn3 is numeric. The precision 
and scale of Co/umn3 can be calculated using the formulas above. 

— If Column? or Column2 is decimal, and the other is integer or numeric, 
Column3 is decimal. The precision and scale of Column3 can be 
calculated using the formulas above. 

— If Column? or Co/lumné is numeric. and the other is integer, Co/umn3 is 
numeric. The precision and scale of Column3 can be calculated using the 
formulas above. 

— If Column? and Columné are large integer, Co/umn3 is large integer. 

— If Column? or Column2 is large integer, and the other is small integer, 
Column3 is large integer. 

— If Column? and Column2 are small integer, Co/umn3 is small integer. 

— If Column? or Column2 is non-zero scale binary, both Column? and 
Column2 must be binary with the same scale. 


In all cases, if Column? and Column2 do not allow null values, Co/umn3 will not 
allow null values. Otherwise, Co/umn3 will permit null values. If the values of 
Column? or Column2 must be converted to conform to Co/umn3, the conversion 
operation is exactly the same as if the values were assigned to Co/umn3. For 
example, if Co/umn? is CHAR(10) and Co/lumn2 is CHAR(5), Co/umn3 is CHAR(10) 
and values of Co/umn3 derived from Co/urmn2 are padded on the right with five 
blanks. 


Examples of a fullselect 
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Example 1: Show all the rows from CORPDATA.EMP. 
SELECT * FROM CORPDATA.EMP 


Example 2: List the employee numbers of all employees whose department 
number begins with D (as determined from the employee table) OR who are 
assigned to projects whose project number begins with AD (as determined from 
the Employee-to-Project-Activity table). 


SELECT EMPNO FROM CORPDATA. EMP 
WHERE WORKDEPT LIKE 'D%' 
UNION 
SELECT EMPNO FROM CORPDATA.EMPPROJA 
WHERE PROJNO LIKE 'AD%' 


c 


select-statement 


pee ee ee ee ees O~*~<i<“ 
order-by-clause— __update-clause—~ 


order-by-clause 


The select-statement is the form of a query that can be prepared and subsequently 
executed by the use of an OPEN statement. It can also be issued interactively, 
using the interactive facility (STRSQL command), causing a result table to be 
displayed at your terminal. In either case, the table specified by a se/ect-statement 
is the result of the fullselect. 


>——-ORDER eles Ee umn-na 
intege 


Puts the rows of the result table in order by the values of the columns you identify. 
If you identify more than one column, the rows are initially ordered by the values of 
the column you identify first, then by the values of the column you identify second, 
and so on. 


column-name 
Must unambiguously identify a column of the result table. 


integer 
Must be greater than 0 and not greater than the number of columns in the 
result table. The integer n identifies the nth column of the result table. 


ASC 
Uses the values of the column in ascending order. This is the default. 


DESC 
Uses the values of the column in descending order. 


A named column may be identified by an integer or acolumn-name. An unnamed 


column must be identified by an integer A column is unnamed if tt is derived from 


a constant, an arithmetic expression, or a function. If the fullselect includes a 


UNION operator, every column of the result table is unnamed. 


Ordering is performed in accordance with the comparison rules described in 
Chapter 2. If your ordering specification does not determine a complete ordering, 
rows with duplicate values of the last identified column have an arbitrary order. 


With dynamic SQL, the ORDER BY clause, like the FOR UPDATE OF clause, must 


be specified when the SELECT statement is prepared, rather than on the DECLARE 
CURSOR statement. 
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The ORDER BY clause can contain up to 256 columns or 256 bytes. If the ORDER 
BY clause contains floating-point columns, only 120 columns or 120 bytes are 
allowed. 


update-clause 


»———-FOR UPDATE OF ae eee 


The UPDATE statement can update only columns in the co/umn-name list. Those 
columns must belong to the table or view named in the FROM clause of the 
SELECT statement. The column names must not be qualified. 


If the FOR UPDATE OF clause is not specified and the ORDER BY clause is not 
specified, all columns can be updated. 


With dynamic SQL, the FOR UPDATE OF clause, like the ORDER BY clause, must 
be specified when the SELECT statement is prepared, rather than on the DECLARE 
CURSOR statement. 


The FOR UPDATE OF clause cannot be used if the result table is read-only. 


Examples of a select-statement 
Example 1: Select all the rows from CORPDATA.EMP. 


SELECT * FROM CORPDATA. EMP 


Example 2: Select all the rows from CORPDATA.EMP in order by date of hiring. 
SELECT * FROM CORPDATA.EMP ORDER BY HIREDATE 
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Chapter 5. Statements 


This chapter contains syntax diagrams, semantic descriptions, rules, and usage 
examples of SQL statements, organized alphabetically by statement name. 


The table below lists statements, summarizes their functions, and indicates the 
page on which a complete description begins. 


Refer 
SQL Statement to 
BEGIN DECLARE SECTION Marks the beginning of a host p. 52 
variable declaration section. 
COMMENT ON Replaces or adds a comment to the p. 55 
description of a table, view, or 
column. 
COMMIT Terminates a unit of recovery and p. 57 


commits the data base changes 
made by that unit of recovery. 
CREATE DATABASE Defines a data base. 
CREATE INDEX Defines an index on a table. p. 60 


CREATE TABLE Defines a table. 


' 


Declares names used to identify 
prepared SQL statements. 


DECLARE STATEMENT 
DELETE 


DESCRIBE 


Deletes one or more rows from a 
table. 


Provides a description of the result p. 75 
columns of a prepared statement. 


DROP Deletes a data base, table, index, 
or view. 

END DECLARE SECTION Marks the end of a host variable p. 79 
declaration section. 

EXECUTE Executes a prepared SOL p. 80 
statement. 

EXECUTE IMMEDIATE Prepares and executes an SQL p. 82 
statement. 

FETCH Assigns values of a row into host p. 84 
variables. 

GRANT Grants privileges on a table or p. 86 
view. 


Figure 2 (Part 1 of 3). SOL Statements 
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Invocation 
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Refer 
SQL Statement to 
INCLUDE Inserts declarations into a source p. 89 
program. 
INSERT Inserts one or more rows into a 
table. 


LABEL ON Replaces or adds a label on the 
description of a table, view, or 
column. 


LOCK TABLE Locks a table in shared or 
exclusive mode. 


PREPARE Prepares an SQL statement for p. oo 
execution. 
REVOKE bet privileges on a table or p. 105 


ROLLBACK Terminates a unit of recovery and p. 107 
backs out the data base changes 
made by that unit of recovery. 


SELECT INTO Specifies a result table of no more 
than one row and assigns values to 
host variables 


UPDATE Updates the values of one or more 
columns in one or more rows of a 


table. 


WHENEVER Defines actions to be taken on the 
basis of SQL return codes. 


Figure 2 (Part 2 of 3). SQL Statements 


All SQL statements can be embedded in an application program, and most can be 
issued interactively. Some statements, however, can only be embedded in an 
application program. 


The phrase ‘embedded in an application program' means that you can specify the 
statement in a source program that will be submitted to an SQL precompiler 
(CRTSQLRPG, CRTSQLCBL, or CRTSQLPLI commands). You must begin such 
statements with EXEC SQL. 


The phrase ‘issued interactively' means that you can specify the statement using 
the interactive facility (STRSQL command). It also means that any SQL program 
can dynamically prepare and execute the statement. Thus, you can also issue 
these statements interactively using a dynamic SQL facility other than the 
interactive facility (STRSQL command). 


some statements that can only be embedded in application programs are not 
executable statements. The precompiler processes these statements and reports 
any errors it encounters. You should not, therefore, follow such statements by a 
test of the SQLCODE field of the SQLCA. You should, however, follow all 
executable statements embedded in an application program by a test of SQLCODE. 


You can use the WHENEVER statement (which is not an executable statement) to 
supplement or replace SQLCODE tests. 
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BEGIN DECLARE SECTION 


Invocation 


Authorization 


The BEGIN DECLARE SECTION statement marks the beginning of a host variable 
declaration section. 


This statement can only be embedded in an application program. It is not an 
executable statement. 


None required. 


BEN BEC AE SO  ——————————————————— 


Description 


Usage Notes 


Example 
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The BEGIN DECLARE SECTION statement may be coded in the application 
program wherever variable declarations can appear in accordance with the rules 
of the host language. It is used to indicate the beginning of a host variable 
declaration section. A host variable section ends with an END DECLARE SECTION 
statement described on page 79. 


Host variables do not need to be declared within a declare section, but should be 
declared within a declare section. 


Host variable declaration sections may be specified for host languages so that the 
source program conforms to the SAA definition of SQL. 


The BEGIN DECLARE SECTION and the END DECLARE SECTION statements must 
be paired and may not be nested. 


No other SQL statements should be included within a declare section. 


Variables referenced in SQL statements should be declared in a declare section 
and the section should appear before the first reference to the variable. 


Variables declared outside a declare section should not have the same name as 
variables declared within a declare section. 


EXEC SQL BEGIN DECLARE SECTION END-EXEC. 


e 
e 
(host variable declarations) 
e 
e 


EXEC SQL END DECLARE SECTION END-EXEC. 


L CLOSE 
The CLOSE statement closes a cursor. 
Invocation 


This statement can only be embedded in an application program. [tis an 
executable statement that cannot be dynamically prepared. 


Authorization 
None is required. See the description of “DECLARE CURSOR’ on page 68 for an 
explanation of the authorization required to use a Cursor. 


>>—CLOSE cursor-nane———____————————— tt 


Description 

cursor-name 
Identifies the cursor to be closed. The cursor-name must identify a declared 
cursor as explained in the Usage Notes for the DECLARE CURSOR statement. 
Vhen the CLOSE statement is executed. the cursor must be in the open state. 

é Usage Notes 

If cursors are not explicitly closed. the open cursors of an application process are 

implicitly closed: 

e At the end of a unit of recovery unless HOLD is specified on the COMMIT or 
ROLLBACK statement. 

e At the end of the first SQL program inthe program stack. For example. if SQL 
program A calls SQL program B. any cursors opened by program B will be 
closed when program A ends. 

e At the end of the job. 

Explicitly closing cursors as soon as possible can improve performance. CLOSE is 
not a COMMIT or ROLLBACK operation. 
Example 


A cursor is used to fetch one row at a time into the program variables ONUM, 
DNAME. and MNUM. Finally, the cursor is closed. If the cursor is reopened, it is 
again located at the beginning of the rows to be fetched 
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SELECT DEPTNO, DEPTNAME, MGRNO 
FROM CORPDATA. DEPT 

WHERE ADMRDEPT = 'AQO! 
END-EXEC. 


EXEC SQL DECLARE C1 CURSOR FOR 


EXEC SQL OPEN C1 END-EXEC. 
EXEC SQL FETCH Cl INTO :DNUM, :DNAME, :MNUM END-EXEC. 
IF SCLCODE = 100 
PERFORM DATA-NOT-FOUND 
EESE 
PERFORM GET-REST-OF-DEPT 
UNTIL SQLCODE IS NOT EQUAL TO ZERO. 
EXEC SQL CLOSE C1 END-EXEC. 


GET-REST-OF-DEPT. 
EXEC SQL FETCH Cl INTO :DNUM, :ONAME, sHAUM END-EXEC. 
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COMMENT ON 


The COMMENT ON statement adds or replaces comments in the catalog 
descriptions of tables, views, or columns. 


Invocation 
This statement can be embedded in an application program or issued interactively. 
It is an executable statement that can be dynamically prepared. 


Authorization 
The privileges held by the authorization ID of the statement must include: 


e The system authority “READ on the library containing the table or view, and 
e Ownership of the table or view, or the system authorities of both “OBJOPR and 
“OBJMGT on the referenced table or view. 


m>>—— COMMENT ON 


ie ae is sac name IS string-constant 
yview- ese) | 
COLUMN table—-name.column- ela 
i a's name.column—-name 


ia aa 

v 

Spe feet column—name IS string-constart+ 
view-name 


Description 
TABLE 
Indicates that you want to comment on a table or view. 


table-name or view-name 
Identifies the table or view to which the comment applies. The tabie or 
view must be described in the catalog. 


COLUMN 
Indicates that you want to comment on a column. 


table-name.column-name or view-name.co/umn-name 
Is the name of the column. qualified by the name of the table or .iew in 
which it appears. 


To comment on more than one column in a table or view, do not use 7~BLE or 
COLUMN. Give the table or view name and then, in parentheses, a: st of this 
form: 


column-name IS string-constant, 
column-name IS string-constant, 


The column named must be described in the catalog and in the refere-ced 
table or view. 
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Is 
Introduces the comment you want to make. J 


string-constant 
Can be any SQL character string constant of up to 254 characters. The 
constant may contain double-byte characters as well as EBCDIC 
characters. 


Usage Notes 
The library that contains the object must be an SQL data base. 


Examples 
Example 1: Enter a comment on table CORPDATA.EMP. 


COMMENT ON TABLE CORPDATA. EMP 
TS "REFLECTS 1ST QTR 81 REORG' 


Example 2: Enter a comment on view CORPDATA.VDE PT 
COMMENT ON TABLE CORPDATA.VDEPT 
IS 'VIEW OF TABLE CORPDATA.TDEPT' 
Example 3: Enter a comment on the DEPTNO column of table CORPDATA.TDEPT. 
COMMENT ON COLUMN CORPDATA.TDEPT.CEPTNG 
IS 'DEPARTMENT ID - UNIQUE! 
Example 4: Enter comments on two columns in table CORPDATA.TDE PT 


COMMENT CN CORPOATA. TDEPT ) 
(HGRNO TS "EMPLOYEE NUMBER OF DEPARTMENT MANAGES! ; 
ADMRDEPT IS "DEPARTMENT NUMBER OF ADMINISTERING 


3 
“I APS wR 
DEPARG| 


my 


ie) 
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COMMIT 


The COMMIT statement terminates a unit of recovery and commits the data base 
changes that were made by that unit of recovery. The moment in the sequence of 
operations at which that is done is called a commit point. 


Invocation 
This statement can be embedded in an application program or issued interactively. 
It is an executable statement that can be dynamically prepared. 


Authorization 
None required. 


ee eee ee UUCU*~*~ Ci 
WORK HOLD 


Description 
The unit of recovery in which the COMMIT statement is executed is terminated and 
a new unit of recovery is initiated All changes made by DELETE, INSERT. and 
UPDATE statements executed during the unit of recovery are committed. 


All locks acquired by the unit of recovery are released. All cursors that were 
opened during the unit of recovery are closed. All statements that were prepared 
during the unit of recovery are destroyed, and any cursors associated with the 
prepared statements are invalidated 


WORK 
COMMIT WORK has the same effect as COMMIT. SQL/400 accepts the 
keyword WORK for compatibility with other data base products. 


HOLD 
Indicates a hold on resources. If specified, currently open cursors are not 
closed, prepared SQL statements are preserved. and all resources acquired 
during the unit of recovery are held. Locks on specific rows acquired during 
the transaction. however, are released. If HOLD is omitted, open cursors are 
closed, prepared SQL statements discarded, and held resources released 


Usage Nofes 
The termination of an application process is an implicit rollback. Thus. an exslicit 
COMMIT or ROLLBACK should be issued before termination. 


A unit of recovery (see “Application Processes. Concurrency, and Recovery on 


page 5 for description) may include the processing of up to 4096 rows, including 
rows retrieved during a SELECT or FETCH statement?, and rows inserted. de!eted, 


2 Unless you specified COMMIT(*CHG), in which case these rows are not included in this 
total. 
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or updated as part of INSERT, DELETE, and UPDATE operations.? A unit of | 
recovery is initiated by the initiation of a unit of work or by the termination of a ») 
previous unit of recovery; it is terminated by a commit operation, a rollback 
operation, or the termination of a unit of work. The commit and rollback operations 
do not affect any data definition statements, and these statements are not, 
therefore, allowed in an application program that also specifies COMMIT(*CHG) or 
COMMIT({*ALL). The data definition statements are: 


© COMMENT 

CREATE DATABASE 
CREATE INDEX 
CREATE TABLE 
CREATE VIEW 

e DROP DATABASE 

e DROP INDEX 
e DROP TABLE 
e DROP VIEW 
e GRANT 

e LABEL 

e REVOKE 


Commitment control is implicitly started by SQL, if necessary, using the system CL 
command STRCMTCTL. The lock level used is based on the COMMIT option 
specified on either the CRTSQLxxx (where xxx is RPG. CBL. or PLI), or the STRSQL 
command. 


A COMMIT is not automatically performed when an application terminates or when 

interactive SQL terminates. In order to commit work performed by an application, wW 
you must issue a COMMIT from within the application. or from outside the 

application with the CL command COMMIT. When a job terminates, an implicit 

ROLLBACK is issued. 


Example 
Commit alterations to the data base made since the last commit point. 


COMMIT WORK 


3 This limit also includes any records accessed or changed through files opened under 
commitment control through high-level language file processing. 
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CREATE DATABASE 


The CREATE DATABASE statement defines a data base in which tables, views, and 
indexes may later be created. 


Invocation 
This statement can be embedded in an application program or issued interactively. 
It is an executable statement that can be dynamically prepared. 


Authorization 
The privileges held by the authorization ID of the statement must include: 


e Authority to the CL command CRTLIB, and 
e Authority to the CL command CRIDTADCT (create data dictionary). 


m>——CREATE DATABASE database-name_-Y + 


Description 
DATABASE database-name 
Names the data base. The name you supply must not be the name of an 
existing SQL data base or a library. 


Usage Notes 
A data base is created as: 


e Alibrary: alibary groups related objects, and allows you to find objects by 
name. 


e Acatalog: a catalog contains descriptions of the tables, views, and indexes in 
the data base. A catalog consists of a data dictionary and a set of views and 
logical files. For more information, see SQL Programmer’s Guide. 


e A journal and journal receiver: a journal QSQURN and journal receiver 
QSQJRNOOO1 is created in the data base, and is used to record changes to all 
tables subsequently created in the data base. For more information, see 
Backup and Recovery Guide. 


When it is created, the system authority “EXCLUDE is initially given to *PUBLIC. 
The owner is the only user having any authority to the data base. If other users 
require authority to the data base, the owner can grant authority to the objects 
created. using the CL command GRTOBJAUT (grant object authority). For more 
information on AS/400 system security, see Programming. Security Guide and 
Programming: Control Language Reference. 


Example 
Create data base DBTEMP. 


CREATE DATABASE DBTEMP 
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The CREATE INDEX statement creates an index on a table. 


C 


Invocation 
This statement can be embedded in an application program or issued interactively. 
lt is an executable statement that can be dynamically prepared. 


Authorization 
The privileges held by the authorization ID of the statement must include: 


e Authority to the CL command CRTLF, and 

e Authorities of “OBJOPR and *ADD on the library and data dictionary containing 
the referenced table, and 

e The INDEX privilege, and one of the following privileges on the referenced 
table: 
= (DELETE 
— INSERT 
= SELECT 
— UPDATE 


If SQL names are specified and the authorization ID is explicitly specified and is 
different from the authorization ID of the statement. you must have *ADD system 
authority to the user profile named by the authorization ID qualifier. 


INDEX index-name——ON table-name——_ i ———_> “weal” 


Description 
UNIQUE 
Prevents the table from containing two or more rows with the same value of 
the index key. The constraint is enforced when rows of the table are updated 
or new rows are inserted. 


The constraint is also checked during the execution of the CREATE INDEX 
statement. Ifthe table already contains rows with duplicate key values, the 
index is not created. 


INDEX index-name 
Names the index. If the index-name ts qualified, the index will be created in 
the specified data base. Otherwise, the index will be created in the data base 
specified by the implicit or explicit qualifier of the specified table. The name 
you give must not be the name of an index. table, view, or file that already - 


exists in the data base. ( ) 
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If SQL naming is specified and the implicit or explicit qualifier also identifies a 


user profile, the “owner” of the index is that user profile. Otherwise, the 
“owner” is the user profile or group user profile of the job invoking the 
statement. 


ON table-name 
Names the table on which you want the index to be created. The table-narne 
must name a table (not a view) described in the catalog. 


(column-name) 
Names a column that is to be part of the index key. 


Each column-name must name acolumn ofthe table. Do not name more than 
120 columns. The same column may be specified more than once. Do not 
qualify the column-name. 


ASC 
Puts the index entries in ascending order by the column. This is the 


default. 


DESC 
Puts the index entries in descending order by the column 


Usage Notes 
An index is created as a keyed logical file. Indexes are created with the system 


authority of “EXCLUDE on *PUBLIC. The maximum length of an index entry is 120 
bytes. 


If the named table already contains data, CREATE INDEX creates the index entries 
© for it. If the table does not yet contain data, CREATE INDEX creates a description 
of the index; the index entries are created when data is inserted into the table. The 
index always reflects the current condition of the table. 


Example 
Create a unique index, named XDEPT1, on table CORPDATA.TDEPT. Index entries 


are to be in ascending order by the single column DEPTNO. 


CREATE UNIQUE INDEX CORPDATA.XDEPT1 
ON CORPDATA. TDEPT 
(DEPTNO ASC) 
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CREATE TABLE 2 


Invocation 


Authorization 


Description 
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m>>——CREATE TABLE table-name 


The CREATE TABLE statement defines a table. You provide the name of the table 
and the names and attributes of its columns. 


This statement can be embedded in an application program or issued interactively. 
It is an executable statement that can be dynamically prepared. 


The privileges held by the authorization ID of the statement must include: 


e The system authorities of “OBJOPR and “ADD on the library and data 
dictionary, and 
e Authority to the CL command CRTPF. 


If SQL names are specified and the authorization ID is explicitly specified and is 
different from the authorization ID of the statement, you must have *ADD system 
authority to the user profile named by the authorization ID qualifier. 


>——( column—name—data-type——NOT NULL ) —____———-+>* ) 


LNOT NULL WITH DEFAULT—! FOR BIT DATA 
FOR SBCS DATA 
LFoR MIXED DATA 


table-name 
Is the name of the table. The name you supply, including the implicit or explicit 
qualifier, must not identify an index, table, view, or file that already exists in 
the data base. 


lf SQL names have been specified, the table will be created in the data base 
specified by the implicit or explicit qualifier. The qualifier is the “owner” of the 
table if a user profile with that name exists. Otherwise, the “owner” of the 
table is the user profile or group user profile of the job invoking the statement. 


If system names have been specified, the table name must be qualified. The 
table will be created in the data base specified by the qualifier. The “owner” of 
the table is the user profile or group user profile of the job invoking the 
statement. 


column-name 
Is the name of a column of the table. Do not qualify co/lumn-name and do not 


use the same name for more than one column of the table. 


You may define up to 8000 columns. The sum of the byte counts of the columns 
must not be greater than 32766. - 


CREATE TABLE 


For information on the byte counts of columns according to data type, see 
“Usage Notes” on page 64. 


data-type 
Is one of the types in the list that follows. Use: 


INTEGER or INT 
For a large integer. 


SMALLINT 
For a small integer. 


FLOAT(integer) 
For a floating-point number. If the integer is between 1 and 24 inclusive. 
the format is that of single precision floating-point. If the integer is 
between 25 and 53 inclusive, the format is that of double precision 
floating-point. If the integer is omitted from the specification, a value of 53 
is assumed, and the number is double precision. 


You may also specify: 


REAL for single precision floating-point 
DOUBLE PRECISION for double precision floating-point 


NUMER|C(integer,integer) 
For a zoned decimal number. The first integer is the precision of the 
number, that is, the total number of digits; it may range from 1 to 31. The 
second integer is the scale of the number, that is. the number of digits to 
the right of the decimal point: it may range from 0 to the precision 


You may use NUMERIC(p) for NUMERIC(p,0), and NUMERIC for 
NUMERIC(5,0). 


DECIMAL(integer,integer) 
For a decimal number. The first integer is the precision of the number: that 
is, the total number of digits: it may range from 1 to 31. The second integer 
is the scale of the number: that is, the number of digits to the right of the 
decimal point; it may range from 0 to the precision. 


You may use DECIMAL(p) for DECIMAL(p,0), and DECIMAL for 
DECIMAL(5,0). You may also specify DEC for decimal. 


CHAR (integer) or CHARACTER(integer) 
For a fixed-length character string of length integer, which may range from 
1 to 32766. If FOR MIXED DATA is specified, the range is 4 to 32766. If the 
length specification is omitted, a length of 1 character is assumed. 


NOT NULL 
Prevents the column from containing null values. 


NOT NULL WITH DEFAULT 
Prevents the column from containing null values, and allows a default value 
other than the null value The default value used depends on the data type of 
the column, as follows: 


Data type Default value 
Numeric 0 
Character blanks 
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Usage Notes 
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FOR BIT DATA J 
Specifies that the character column contains hex data (that is, data that is not 
text of a particular code page). A zerois returned for the character set and 
code page inthe SQL Descriptor Area (SQLDA) on a DESCRIBE or PREPARE 
statement for a character column defined with FOR BIT DATA. 


FOR SBCS DATA 
Specifies that the character column contains SBCS (single byte character set) 
data. The system value QCHRID specifies the character set and code page of 
all SBCS data on the system. The character set and code page of a character 
column is returned in the SQL Descriptor Area (SQLDA) on DESCRIBE and 
PREPARE statements. FOR SBCS DATA is the default for CHAR columns if the 
system is not DBCS-capable or if the length of the column is less than 4. This 
is determined using the QIGC system value. 


FOR MIXED DATA 
Specifies that the character column contains both SBCS (single byte character 
set) data, and DBCS (double byte character set) data. The system value 
QCHRID specifies the character set and code page of the SBCS data. The 
character set and code page of a character column is returned in the SQL 
Descriptor Area (SQLDA) on DESCRIBE and PREPARE statements. FOR 
MIXED DATA is the default for CHAR columns if the system is DBCS-capable 
and the length of the column is greater than 3. This is determined using the 
QIGC system value. If the system is not DBCS-capable, and FOR MIXED DATA 
is specified, an error occurs. AFOR MIXED DATA column is used as a 
DBCS-Open data base field. 


Tables are created as physical files with the system authority of “EXCLUDE to J 
*PUBLIC. When a table is created, journaling is automatically started on the 
journal named QSQURN in the data base. 


Maximum record size: The “maximum record size” referred to in the description 
of column-name is 32766. To determine the length of a record, add the length of 


each column of that record based on the byte count of the data type. 


The list that follows gives the byte counts of columns by data type. 


Data type Byte count 

INTEGER 4 

INT 4 

SMALLINT 2 

FLOAT(n) Ifn is between 1 and 24. the byte count is 4. If nis between 


25 and 53, the byte count is 8. 
DOUBLE PRECISION 8 


REAL 4 
DECIMAL{p, s) the integral part of (p/2) + 1 
NUMERIC(p, s) p 
CHAR(n) n 


C 


Examples 


CREATE TABLE 


Precision as described to the data base: 


e Floating point fields are defined in the AS/400 system data base with a decimal 
precision, not a bit precision. The algorithm used to convert the number of bits 
to decimal is decimal precision = x(n/3.31), where x is the smallest integer 
greater than or equal to the argument, and n is the number of bits to convert. 
The decimal precision is used to determine how many digits to display using 
interactive SQL. 


e SMALLINT fields are stored with a decimal precision of 4,0. 


e INTEGER fields are stored with a decimal precision of 9.0. 


Example 1: Create CORPDATA’s table, TDEPT. DEPTNO, DEPTNAME, MGRNO. 
and ADMRDEPT are column names. CHAR means the column will contain 
character data. NOT NULL means that the column cannot contain a null value. 


CREATE TABLE CORPDATA. TDEPT 
(DEPTNO  CHAR(3) NOT NULL WITH DEFAULT, 
DEPTNAME CHAR(36) NOT NULL WITH DEFAULT, 
MGRNO CHAR(6) NOT NULL WITH DEFAULT, 
ADMRDEPT CHAR (3) NOT NULL WITH DEFAULT) 


Example 2: Create CORPDATA’s table, PROJ. PROJNO, PROJNAME, DEPTNO, 
RESPEMP, PRSTAFF, PRSTDATE, PRENDATE, and MAJPROJ are column names. 
CHAR means the column will contain character data. DECIMAL means the column 
will contain packed decimal data. 5,2 means the following: 5 indicates the number 
of decimal digits, and 2 indicates the number of digits to the right of the decimal 
point. NOT NULL means that the column cannot contain a null value. 


CREATE TABLE CORPDATA.PROJ 


(PROJNO  CHAR(6) NOT NULL WITH DEFAULT, 
PROJNAME CHAR(24) NOT NULL WITH DEFAULT, 
DEPTNO CHAR(3) NOT NULL WITH DEFAULT, 
RESPEMP CHAR(6) NOT NULL WITH DEFAULT, 


PRSTAFF DECIMAL(5,2) NOT NULL WITH DEFAULT, 
PRSTDATE DECIMAL(6) NOT NULL WITH DEFAULT, 
PRENDATE DECIMAL(6) NOT NULL WITH DEFAULT, 
MAJPROJ CHAR(6) NOT NULL WITH DEFAULT) 
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Invocation 


Authorization 


The CREATE VIEW statement creates a view on one or more tables or views. 


This statement can be embedded in an application program or issued interactively. 
It is an executable statement that can be dynamically prepared. 


The privileges held by the authorization ID of the statement must include: 


Authority to the CL command CRITLF (create logical files), and 

The system authorities “OBJOPR and *ADD on the library and data dictionary 
containing the referenced tables, and 

The SELECT, UPDATE, DELETE, or INSERT privilege on all the tables 
referenced either directly through the subselect, or indirectly through views 
referenced in the subselect. 


If SQL names are specified and the authorization ID that is explicitly specified is 
different from the authorization ID of the statement. you must have *ADD authority 
on the user profile named by the authorization ID qualifier. 


m>——CREATE VIEW view-name | 


»———-AS subselect 


Description 
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view-name 


Is the unqualified or qualified name of the view. The unqualified name must 
not be the same as any table, view, index. or file that already exists in the data 
base. 


For SQL naming, the view goes into the implicitly or explicitly specified data 
base. The owner in SQL naming is the authorization ID of the statement if a 
user profile of that name exists; otherwise, the owner is the user profile or 
group user profile of the job invoking the statement. 


For system naming, the view goes into the specified data base if the view name 
is explicitly qualified. If the view name is not explicitly qualified, the view goes 
into the data base that contains the first table referenced in the subselect. 


column-name 


Is a list of one or more names for columns in the view. If you specify the list, it 

must consist of as many names as there are columns in the result table of the 

subselect. Each name must be unique and unqualified. If you do not specify a 

list of column names, the columns of the view inherit the names of the columns : 

of the result table of the subselect. YQ 


Usage Notes 


Example 


CREATE VIEW 


You must specify a list of column names if the result table of the subselect has 
duplicate column names or an unnamed column (a column derived from a 
constant, function, or expression). 


AS subselect 
Defines the view. At any time, the view consists of the rows that would result if 


the subselect were executed. 


subselect must not reference host variables. See Chapter 4, “Queries” on 
page 39 for an explanation of subselect. 


Views are created as non-keyed logical files with system authority of “EXCLUDE to 
*PUBLIC. 


Read-only views: A view is read-only if its definition involves any of the following: 


e The first FROM clause identifies more than one table or view 
e The keyword DISTINCT 

e A GROUP BY clause 

e A HAVING clause 

e Acolumn function 

e The first FROM clause identifies a read-only view. 


A read-only view cannot be the object of an INSERT, UPDATE, or DELETE 
statement. 


A view cannot reference more than 32 real tables, including real tables referenced 
by underlying views. 


A view cannot address more than 8000 columns. The number of referenced tables, 
the column name lengths. and the length of the WHERE clause further reduce this 
number. 


Limitations 
e FOR UPDATE OF, ORDER BY, and UNION cannot be used in the definition of a 
view. 


e Host variables are not allowed in the definition of a view. 
e USER or LENGTH cannot be used in the definition of a view. 


Testing a view definition: You can test the semantics of your view definition by 
executing SELECT * FROM view-name. 


Create the view CORPDATA.VPROJRE1. PROJNO, PROJNAME. PROJDEP. 
RESPEMP, EMPNO. FIRSTNME, MIDINIT, and LASTNAME are column names. The 
view is a join of tables CORPDATA. PROJ and CORPDATA.EMP. where a value in 
the RESPEMP column is equal to a value in the EMPNO column. 


CREATE VIEW CORPDATA.VPROJRE1 
(PROJNO, PROJNAME , PROUDEP, RESPEMP, 
FIRSTNME,MIDINIT,LASTNAME) 
AS SELECT ALL 
PROJNO, PROUNAME, DEPTNO, EMPNO, 
FIRSTNME ,MIDINIT, LASTNAME 
FROM CORPDATA.PROJ, CORPDATA. EMP 
WHERE RESPEMP = EMPNO 
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Invocation 


Authorization 


Pe DEC CARE US Sa ——$—SS 08 OSS SS 


The DECLARE CURSOR statement defines a cursor. 


This statement can only be embedded in an application program. It is not an 
executable statement. 


No authorization is required to use this statement. However, to use OPEN or 
FETCH for the cursor, the privileges held by the authorization ID of the statement 
must include the SELECT privilege on every table and view identified in the 
SELECT statement of the cursor. Authority is checked at execution time during 
OPEN and during the processing of the statements that reference the open cursor. 


The SELECT statement of the cursor is either: 


1. The SELECT statement identified by se/ect-stafement, in which case the 
authorization |D is the owner of the program. 


2. The prepared SELECT statement identified by a statement-name clause, in 
which case the authorization ID is the run-time authorization ID. 


SS oe SS ee) SSS SSS ee wd 


Statement—name 


Description 
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A cursor with the specified name is created when your source program is run. The 
name must not be the same as the name of another cursor declared in your source 
ert tt A CC A tL eT nase ete, 


program. 


A cursor in the open state designates a resu/t fable and a position relative to the 
rows of that table. The table is the result table specified by the SELECT statement 
of the cursor. 
The result table is read-only if: 
e The SELECT statement includes: 
— The keyword DISTINCT 
— A UNION operator 
— Accolumn function 


— A GROUP BY or HAVING clause. 


Usage Notes 


DECLARE CURSOR 


e The first FROM clause of the SELECT statement identifies: 
— More than one table or view 


— A read-only view. 


Specifying the SELECT Statement: If se/ect-statement is specified, it identifies the 
SELECT statement of the cursor. 


The se/ect-statement must not include parameter markers, but may include 
references to host variables. The declarations of the host variables must precede 
the DECLARE CURSOR statement in the source program. See “select-statement” 
on page 47 for an explanation of fullselect. 


If the ORDER BY clause is not specified, the rows of the result table have an 
arbitrary order. 


Naming the SELECT Statement: If a sfatement-name is specified, the SELECT 
statement of the cursor is the prepared SELECT statement identified by the 
statement-name when the cursor is opened. The sfatement-name must not be 
identical to a statement-name specified in another DECLARE CURSOR statement of 
your source program. 


See “PREPARE” on page 101 for an explanation of prepared SELECT statements. 


A SELECT statement is evaluated at the time the cursor is opened. If the same 
cursor is opened, closed, and then opened again, the results may be different. 
Multiple cursors using the same SELECT statement may be opened concurrently. 
They are each considered independent activities. 


A cursor is automatically closed when the job terminates. A cursor is also closed 
whenever a COMMIT (no HOLD) or ROLLBACK (no HOLD) statement is issued, or 
when the last SQL program in the program stack ends. 


If ORDER BY is specified and FOR UPDATE OF is not specified, the cursor is 
read-only. If ORDER BY is specified and FOR UPDATE OF is specified, the 
columns inthe FOR UPDATE OF clause can not be the same as any columns 
specified in the ORDER BY clause. 


The ORDER BY clause can contain up to 256 columns or 256 bytes. If the ORDER 
BY clause contains floating-point columns, only 120 columns or 120 bytes are 
allowed. If more than 120 bytes are used, the cursor is read-only. 


If the FOR UPDATE OF clause is omitted, only the columns in the SELECT clause of 
the subselect that can be updated can be changed. 


The DECLARE CURSOR statement must precede all statements that explicitly 
eee eee 


reference the cursor by name. 


The scope of cursor-name is the source program in which it is defined; that is, the 
program submitted to the precompiler. Thus, you can only reference a cursor by 
statements that are precompiled with the cursor declaration. For example, a 
program called from another separately compiled program cannot use a cursor 
that was opened by the calling program. 
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DECLARE CURSOR 


Examples 
Example f: The DECLARE CURSOR statement associates the cursor name C1 with J 
the results of the SELECT. 


EXEC SQL DECLARE C1 CURSOR FOR 
SELECT DEPTNO, DEPTNAME, MGRNO 
FROM CORPDATA. TDEPT 
WHERE ADMRDEPT = 'AQQ! 
END-EXEC. 


Example 2: The DECLARE CURSOR statement associates the cursor name C1 with 
the results of the SELECT. MGRNO and MGRNAME may be updated. FOR 
UPDATE OF can specify a column that is not in the select list. 


EXEC SQL DECLARE C1 CURSOR FOR 
SELECT DEPTNO, DEPTNAME, MGRNO 
FROM CORPDATA. TDEPT 
WHERE ADMRDEPT = 'A@Q' 

FOR UPDATE OF MGRNO, MGRNAME 
END-EXEC. 
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DECLARE STATEMENT 


The DECLARE STATEMENT statement is used for program documentation. It 
declares names that are used to identify prepared SQL statements. 


Invocation 
This statement can only be embedded in an application program. It is not an 
executable statement. 


Authorization 
None required. 


too ae 


me—§ DECLARE en aa ere 


Description 
statement-name STATEMENT 
Lists one or more names that are used in your program to identify prepared 
SQL statements. 
Example 


This example shows the use of the DECLARE STATEMENT statement in a PL/I 
program. 


EXEC SQL DECLARE OBJ STMT STATEMENT; 


( SOURCE STATEMENT is "SELECT DEPTNO, DEPTNAME, 
MGRNO FROM CORPDATA.TDEPT WHERE ADMRDEPT = 'AQO'" 


EXEC SQL INCLUDE SQLDA; 
EXEC SQL DECLARE C1 CURSOR FOR OBJ STMT; 


EXEC SQL PREPARE OBJ STMT FROM :SRCE_STMT; 
EXEC SQL DESCRIBE OBJ STMT INTO :SQLDA; 


(Examine SQLDA) 
EXEC SQL OPEN Cl; 


DO WHILE (SQLCODE = 0); 
EXEC SQL FETCH Ci USING DESCRIPTOR :SQLDA; 


(Print results) 
END; 


EXEC SQL CLOSE C1; 
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DELETE 
The DELETE statement deletes rows from a table or view. Deleting a row froma 
view deletes the row from the table on which the view is based. 

Invocation 
This statement can be embedded in an application program or issued interactively. 
It is an executable statement that can be dynamically prepared. 

Authorization 


The privileges held by the authorization ID of the statement must include the 
DELETE privilege on the specified table or view. 


You have the DELETE privilege on a table if any of the following apply: 


e You are the owner of the table. 
e You have been granted the DELETE privilege on the table. 
e You have been granted the system authorities “OBJOPR and *DLT on the table. 


You have the DELETE privilege on a view if any of the following apply: 


e You have been granted the DELETE privilege on the view. 

e You created the view, you had the DELETE privilege on its base table when the 
view was Created, and you still have that DELETE privilege. 

e You have been granted the system authority *OBJOPR on the view and the 
system authority “DLT on the base table. 


Searched Delete 


p>——DELETE ee erage a ee ep 
view-name correlation-name 
L WHERE SEAueR-SOhciL =" 


Positioned Delete 


m>>—DELETE ee he Ee. 
view-name 


P= WHERE CURRENT (OF “Cursor an@ == ee ee 


Description 
FROM fable-name or view-name 
Names the table or view from which you want to delete. It must have been 
created previously, but must not be a catalog table, a view of a catalog table, 
or a read-only view. (See “CREATE VIEW” on page 66 for an explanation of 
read-only views.) 


correlation-name 
May be used within the search-condition to designate the table or view. (See 


Chapter 2 for an explanation of correlation-name.) 
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Usage Notes 


Examples 


DELETE 


WHERE 
Specifies a condition that selects the rows to be deleted. You can omit the 
clause, give a search condition, or name acursor. If you omit the clause, all 
rows of the table or view are deleted. 


search-condition 
Is any search condition as described in Chapter 2. Each column-name in 
the search condition must name a column of the table or view. 


The search-condition is applied to each row of the table or view and the 
deleted rows are those for which the result of the search-condition is true. 


CURRENT OF cursor-name 
Identifies the cursor to be used in the delete operation. The cursor-name 
must identify a declared cursor as explained in the Usage Notes for the 
DECLARE CURSOR statement. 


The table or view named must also be named in the FROM clause of the 
SELECT statement of the cursor, and the result table of the cursor must not 
be read-only. (For an explanation of read-only result tables. see 
“DECLARE CURSOR’ on page 68.) 


When the DELETE statement is executed, the cursor must be positioned on 
a row: that row is the one that is deleted. After the deletion, the cursor is 
positioned before the next row of its result table. If there is no next row, 
the cursor is positioned after the last row. 


Note that the deletion of arow WHERE CURRENT OF a specified cursor 
may leave other cursors pointing to the deleted record. 


A maximum of 4096 rows may be deleted in any single DELETE operation when 
COMMIT(*ALL) or COMMIT(“CHG) has been specified. 


If an error occurs during the execution of a DELETE statement and COMMIT(*ALL) 
or COMMIT(*CHG) was specified, all changes made during the execution of the 
statement are backed out. However, other changes in the unit of recovery made 
prior to the error are not backed out. If COMMIT(*"NONE) is specified, changes are 
not backed out. a multiple row DELETE, 


When a DELETE statement completes, the number of rows deleted is returned in 
SQLERRD(3) in the SQLCA. (For a description of the SQLCA, see 
Appendix B, “SQLCA and SQLDA Control Blocks” on page 119.) 


One or more exclusive locks are acquired by the execution of a successful DELETE 
statement. Until the locks are released, they may prevent other application 
processes from performing operations on the table. For further information about 
locking, see the description of the COMMIT, ROLLBACK, and LOCK TABLE 
statements. Refer also to Dafa Base Guide. 


Example 1: Delete one row from table CORPDATA.TDEPT. 


DELETE FROM CORPDATA.TDEPT 
WHERE DEPTNO = 'D1l1' 
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DELETE 


Example 2: Delete several rows from table CORPDATA.EMP: those for all 
employees in Department E11 or D217. 


DELETE FROM CORPDATA.EMP 
WHERE WORKDEPT = 'E11' 
OR WORKDEPT = 'D21' 


74 SOL/400 Reference 


. 


S DESCRIBE 


The DESCRIBE statement obtains information about a prepared statement. See the 
description of “PREPARE” on page 101 for an explanation of prepared statements. 


Invocation 
This statement can only be embedded in an application program. It is an 


executable statement that cannot be dynamically prepared. 


Authorization 
None required. See “PREPARE’™ on page 101 for information on the authorization 


required to create a prepared statement. 


>>——DESCRIBE statement-name—INTO descriptor—name 
NAMES 
USING LABELS 


ANY 
BOTH 


Description 
statement-name 
w Names the statement about which you want to obtain information. When the 
DESCRIBE statement is executed, the name must identify a prepared 
statement. 


INTO descriptor-name 
Names an SQL descriptor area (SQLDA). When the DESCRIBE statement is 
executed, values are assigned to the variables of the SQLDA. For information 
about the format of an SQLDA. see Appendix B, “SQLCA and SQLDA Control 
Blocks” on page 119. 


USING 
Indicates what value to assign to each SQLNAME variable in the SQLDA. If the 
requested value does not exist, SQLNAME is set to a length of 0. 


NAMES 
Assigns the name of the column. The default is USING NAMES. 


LABELS 
Assigns the label of the column. (Column labels are defined by the LABEL 


ON statement.) 


ANY 
Assigns the column label and if the column has no label, the column 
name. 


BOTH 
Assigns both the label and name of the column. In this case, two 
occurrences of SQLVAR per column will be needed to accommodate the 
additional information. To specify this expansion of the SQLVAR array, set 
& SQLN to 2*n on the PREPARE statement (where nis the number of 
columns in the result table). Then, on any later FETCH statement, set 
SQLN ton. The first m occurrences of SQLVAR for each of the columns in 
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the result table contain the column names. The second n occurrences , 
contain the column labels. SD 


Usage Notes 
Information about a prepared statement can also be obtained by using the INTO 


clause of the PREPARE statement. 


Before the DESCRIBE or PREPARE INTO statement is executed, the value of SQLN 
must be set to indicate how many occurrences of SQLVAR are provided in the 
SQLDA. To obtain the description of the columns of the result table of a prepared 
SELECT statement, the number of occurrences of SQLVAR must not be less than 
the number of columns. 


If USING BOTH is specified and SQLN is less than 2*SQLD, then SQLD is set to 2 * 
(number of columns). If USING BOTH is specified and SQLN is greater than or 
equal to 2*SQLD, then SQLD is set to the number of columns. 


Because the maximum number of columns is 8000, a simple technique is to 
provide an SQLDA with 8000 occurrences of SQLVAR. However, such an SQLDA 
will occupy a good deal of space, and most of this space will not be needed for 
most prepared statements. Thus, you might want to consider another technique, 
such as the following: 


Execute a DESCRIBE or PREPARE INTO statement with an SQLDA that has no 

occurrences of SQLVAR. If SQLN is greater than zero, use the value to allocate 

an SQLDA with the necessary number of occurrences of SQLVAR and then 

execute a DESCRIBE statement using that SQLDA. J 


Example 
This PL/1 example uses the technique described above. SOURCE is a 
varying-length string variable and SHORTDA is an SQLDA with no occurrences of 
SQLVAR. 


EXEC SQL INCLUDE SQLDA; 
(Read an SQL statement into SOURCE) 
EXEC SQL PREPARE OBJSTATE INTO :SHORTDA 

FROM :SOURCE; 
(Check for successful execution. If the value of SQLN is greater than 0, the source 
statement was SELECT; use the value of SQLN to allocate and initialize SQLDA.) 
EXEC SQL DESCRIBE OBUSTATE INTO :SQLDA; 
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DROP 


The DROP statement deletes an object. Any objects that are directly or indirectly 
dependent on that object are also deleted. Whenever an object is deleted, its 
description is deleted from the catalog. 


Invocation 
This statement can be embedded in an application program or issued interactively. 
It is an executable statement that can be dynamically prepared. 


Authorization 
To drop a table, view, or index, the privileges held by the authorization ID of the 
statement must include: 


e The system authorities “OBJOPR and *DLT on the referenced library, and 

e The system authority *“OBJEXIST on the object to be dropped. For tables, you 
will also need the “OBJEXIST authority on all views, indexes. and logical files 
that reference the table. 


To drop a data base, the privileges held by the authorization ID of the statement 
must include: 


e The system authority “OBJEXIST on the data base to be dropped. and 
e The system authority “OBJEXIST on all objects in the data base, and to any 
views, indexes, and logical files that reference those objects. 


TABLE table-name 
>>——DROP VIEW view-name 
INDEX index-name 


L_DATABASE database-name-———H_——__ 


Description 
TABLE ftab/e-name 

Identifies the table you want to drop. The table specified must be described in 
the catalog and cannot be a catalog table. The specified table is deleted from 
the data base. All indexes. views, and logical files defined on the table are 
dropped. Any access plans that exist in programs that have dependencies on 
the table will be recreated when the program that contains the access plan is 
next run. If the referenced table does not exist at that time, a negative value 
will be returned in the SQLCODE field of the SQLCA. 


VIEW view-name 
Identifies an existing view other than a catalog view. The definition of the view 
is deleted from the catalog. The definition of any view that is directly or 
indirectly dependent on that view is also deleted. Any access plans that exist 
in programs that have dependencies on the view will be recreated when the 
program that contains the access plan is next run. If the referenced view does 
not exist at that time. a negative value will be returned in the SQLCODE field of 
the SQLCA. 
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INDEX index-name 


Identifies an index described in the catalog. Indexes can be dropped at any 
time except when they are in use. Any access plans that exist in programs that 
have dependencies on the index will be recreated when the program that 
contains the access plan is next run. If the referenced index does not exist at 
that time, a negative value will be returned in the SQLCODE field of the 
SQLCA. 


DATABASE database-name 


Identifies the data base you want to drop. All objects in the data base and the 
library are dropped. Any access plans that exist in programs that have 
dependencies on any object in the data base will be recreated when the 
program that contains the access plan is next invoked. If the referenced data 
base does not exist at that time, a negative value will be returned in the 
SQLCODE field of the SQLCA. 


Example 1: Drop table CORPDATA.TDEPT. 
DROP TABLE CORPDATA. TDEPT 


Example 2: Drop the view VDEPT. 
DROP VIEW VDEPT 


ww 


END DECLARE SECTION 


Invocation 


Authorization 


Description 


Usage Notes 


Example 


The END DECLARE SECTION statement marks the end of a host variable 
declaration section. 


This statement can only be embedded in an application program. It is not an 
executable statement. 


None required. 


The END DECLARE SECTION statement may be coded in the application program 
wherever declarations can appear in accordance with the rules of the host 
language. It is used to indicate the end of a host variable declaration section. A 
host variable section starts with a BEGIN DECLARE SECTION statement described 
on page 92. 


Host variables do not need to be declared within a declare section, but should be 
declared within a declare section. 


Host variable declaration sections may be specified for host languages so that the 
source program conforms to the SAA definition of SQL. 


The BEGIN DECLARE SECTION and the END DECLARE SECTION statements must 
be paired and may not be nested. 


No other SQL statements should be included in the declare section. 


Variables referenced in SQL statements should be declared in a declare section 
and the section should appear before the first reference to the variable. 


Variables declared outside a declare section should not have the same name as 
variables declared within a declare section. 


EXEC SQL BEGIN DECLARE SECTION END-EXEC. 
® 
e 
(host variable declarations) 
e 
e 


EXEC SQL END DECLARE SECTION END-EXEC. 
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EXECUTE (JQ 


The EXECUTE statement executes a prepared SQL statement. 


Invocation 
This statement can only be embedded in an application program. It is an 
executable statement that cannot be dynamically prepared. 


Authorization 
The authorization rules are those defined for the dynamic preparation of the SQL 
statement specified by EXECUTE. For example, see the description of INSERT for 
the authorization rules that apply when an INSERT statement is executed using 
EXECUTE. 


m>>—FXECUTE statenent-—naane—o£. oOo ——M@ — 


rr a 


|—ustne—"host-variab 
USING DESCRIPTOR descriptor—name 


Description 
sfatement-name 

identifies the prepared statement to be executed. statement-name must 
identify a statement that was previously prepared within the unit of recovery 
and the prepared statement must not be a SELECT statement. The prepared 
statement may have been prepared in a previous unit of recovery if COMMIT 
HOLD or ROLLBACK HOLD have been used to preserve the prepared 
Statement. 


USING 
introduces a list of host variables whose values are substituted for the 
parameter markers (question marks) in the prepared statement. (See 
“PRE PARE™ on page 101 for an explanation of parameter markers.) If the 
prepared statement includes parameter markers, you must use USING. USING 
is ignored if there are no parameter markers. 


host-vanable 
identifies a variable that is described in the program in accordance with 
the rules for declaring host vanabies The number of variables must be 
the same as the number of parameter markers in the prepared statement. 
The nth vanable corresponds to the nth parameter marker in the prepared 
statement. 


DESCRIPTOR cescriptor-name 
identifies an SQLDA that must contain a valid description of host variables 
The number of variables, as indicated by SQLD. must be the same as the 
number of parameter markers in the prepared statement and the length of 
the SQLDA. as indicated by SQLDABC. must be sufficient to describe that | 
number of vanables. The nth variable described by the SQLDA 
corresponds to the nth parameter marker in the prepared statement. Note 
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Usage Notes 


Example 


EXECUTE 


that because RPG and COBOL do not provide the facility for setting 
pointers, and the SQLDA uses pointers to locate the appropriate host 
variables, you will have to set these pointers outside your RPG or COBOL 
application. (For a description of an SQLDA, see Appendix B, “SQLCA 
and SQLDA Control Blocks” on page 119.) 


Before the prepared statement is executed, each parameter marker is effectively 
replaced by the value of its corresponding host variable. Each value that replaces 
a parameter marker must be compatible with operations applied to it during the 
execution of the prepared statement, as follows: 


e If a parameter marker appears as the operand of an arithmetic operator, its 
value is converted to conform to the description of the other operand, if 
necessary, according to the rules described in Chapter 2. In the case of unary 
minus, the value is converted to double precision floating-point. 


e |f a parameter marker appears in place of a numeric value to be inserted ina 
column, its value is the number that would result if the host variable were 
assigned to the column, and the value must conform to the rules for 
assignments. 


e lf a parameter value is used as the operand of a comparison operator, it must 
be compatible with the other operand of that operator. and its length must not 
be greater than that of the other operand. 


In this example, an INSERT statement with parameter markers is prepared and 
executed. 


MOVE 'INSERT INTO CORPDATA.QUOTATIONS VALUES(?,?,?,?)' TO HOLDER. 
EXEC SQL PREPARE QUOTES FROM :HOLDER END-EXEC. 


IF SQLCODE = 0 

PERFORM EXECUTE-INSERT 
ELSE 

PERFORM ERROR-CONDITION. 


EXECUTE-INSERT. 
MOVE 51 TO SUPPNO. 
MOVE 221 TO PARTNO. 
MOVE 0.30 TO PRICE. 
MOVE 50 TO QONORDER. 


EXEC SQL EXECUTE QUOTES USING :SUPPNO, 


:PARTNO, :PRICE, :QONORDER 
END-EXEC. 
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EXECUTE IMMEDIATE oe 
The EXECUTE IMMEDIATE statement: 


e Prepares an executable form of an SQL statement from a character string form 
of the statement. 


e Executes the SQL statement. 


e Destroys the executable form. 


Invocation 
This statement can only be embedded in an application program. It is an 


executable statement that cannot be dynamically prepared. 


Authorization 
The authorization rules required are those defined for the dynamic preparation of 


the SQL statement specified by EXECUTE IMMEDIATE. For example, see the 
description of the INSERT statement for the authorization rules that apply when an 
INSERT statement is executed using EXECUTE IMMEDIATE. 


The run-time authorization ID must have the authorization required to execute the 
statement specified by the EXECUTE IMMEDIATE statement. 


m>——FEXECUTE Baa se a | a aaa | 
host-variable ) 


Description 
string-expression 
A string-expression is any expression that yields a character string. 


host-variable 
In COBOL and RPG a host variable must be specified. If a host variable is 
specified, it must identify a host variable that is described in the program in 
accordance with the rules for declaring character string variables. 


The host variable must be of the form :host-variable. The form 
shost-variable:indicator-variable is not allowed. 


Usage Notes 
The character string form of the statement is called a statement string. The 
statement string is the value of the specified string-expression or the identified 
host variable. 


The statement string must be one of the following SQL statements: COMMENT ON, 
COMMIT, CREATE DATABASE, CREATE INDEX, CREATE TABLE, CREATE VIEW, 
DELETE, DROP, GRANT, INSERT, LABEL ON, LOCK TABLE, REVOKE, ROLLBACK, 
OR UPDATE. 


The statement string must not include parameter markers or references to host f ) 


variables, must not begin with EXEC SQL, and must not terminate with END-EXEC 
or a semicolon. 
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Example 


EXECUTE IMMEDIATE 


When an EXECUTE IMMEDIATE statement is executed. the specified statement 
string is parsed and checked for errors. If the SQL statement is invalid, it is not 
executed and the error condition that prevents its execution is reported in the 
SQLCA. If the SQL statement is valid, but an error occurs during its execution, that 
error condition is reported in the SQLCA. 


If the same SQL statement is to be executed more than once, it is more efficient to 
use the PREPARE and EXECUTE statements, rather than the EXECUTE IMMEDIATE 
statement. 


In this COBOL example, the EXECUTE IMMEDIATE statement is used to execute a 
DELETE statement. 


MOVE 'DELETE FROM QUOTATIONS WHERE 
PRICE > 1.00' TO HOLDER. 


EXEC SQL EXECUTE IMMEDIATE :HOLDER END-EXEC. 
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FETCH J 
The FETCH statement positions a cursor on the next row of its result table and 
assigns the values of that row to host variables. 


Invocation 
This statement can only be embedded in an application program. It is an 


executable statement that cannot be dynamically prepared. 


Authorization 
The privileges held by the authorization ID of the statement must include the 


SELECT privilege on every table or view identified in the SELECT statement of the 
cursor. 


FP PIC ssieicasis- oe cbs hiccceeailel--_——p-oyccveaponsscessacte 


USING DESCRIPTOR descriptor-name—~ 


Description 
cursor-name 


Identifies the cursor to be used in the fetch operation. The cursor-name must | 
identify a declared cursor as explained in the Usage Notes for the DECLARE - 
CURSOR statement. When the FETCH statement is executed. the cursor must 

be in the open state. 


lf the cursor is currently positioned on or after the last row of its result table, 
the SQLCODE field of the SQLCA is set to +100. the cursor is positioned “after 
the last row,” and values are not assigned to host variables. 


If the cursor is currently positioned before a row, the cursor is positioned on 
that row, and values are assigned to host variables as specified by INTO or 
USING. 


If the cursor is currently positioned on a row other than the last row, the cursor 
is positioned on the next row, and values of that row are assigned to host 
variables as specified by INTO or USING. 


INTO host-variable 
If INTO is used, each host variable must identify a variable that is described in 
your program in accordance with the rules for declaring host variables. The 
first value of a row corresponds to the first variable, the second value 
corresponds to the second variable. and so on. 


USING DESCRIPTOR descriptor-name 
If USING DESCRIPTOR is used, the descriptor-name must identify an SQLDA 
that contains a valid description of zero or more host variables. The length of 
the SQLDA, as indicated by SQLDABC, must be sufficient to describe the 
number of variables indicated by SQLD. The first value of a row corresponds 
to the first variable described by the SQLDA, the second value corresponds to 
the second variable, etc. ‘J 
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Usage Notes 


Example 


FETCH 


Note that because RPG and COBOL do not provide the facility for setting 
pointers, and the SQLDA uses pointers to locate the appropriate host 
variables, you will have to set these pointers outside your RPG or COBOL 
application. 


The data type of a host variable must be compatible with its corresponding value. 
If the value is numeric. the variable must have the capacity to represent the whole 
part of the value. Ifthe value is null, an indicator variable must be specified. 


Assignments are made in sequence through the list. Each assignment to a 
variable is made according to the rules described in Chapter 2, “Language 
Elements.” If the number of variables is less than the number of values in the row, 


the SQLWARNS field of the SQLDA is set to 'W'. 


lf an error occurs as the result of an arithmetic expression in the SELECT list 
(division by zero, overflow etc.) or a numeric conversion error occurs, the result is 
the null value. As in any other case of a null value, an indicator variable must be 
provided and the main variable is unchanged. In this case, however, the indicator 
variable is set to-2. Processing of the statement continues as if the error had not 
occurred. If you do not provide an indicator variable, a negative value is returned 
in the SQLCODE field of the SQLCA. Processing of the statement terminates when 
the error is encountered. No value is assigned to the host variable or to later 
variables, though any values that have already been assigned to variables remain 
assigned. 


If the specified host variable is character and is not large enough to contain the 
result, 'W' is assigned to SQLWARN1 in the SQLCA. The actual length is returned 
in the indicator variable, if provided. 


The FETCH statement fetches the results of the SELECT statement into the 
program variables DNUM, DNAME, and MNUM. 


EXEC SQL DECLARE C1 CURSOR FOR 
SELECT DEPTNO, DEPTNAME, MGRNO FROM CORPDATA. TDEPT 
WHERE ADMRDEPT = 'AQQ' 
END-EXEC. 


EXEC SQL OPEN Cl END-EXEC. 
EXEC SQL FETCH Cl INTO :DNUM, :DNAME, :MNUM END-EXEC. 
IF SQLCODE = 100 


PERFORM DATA-NOT-FOUND 
ELSE 


PERFORM GET-REST-OF-DEPT 
UNTIL SQLCOBE IS NOT EQUAL TO ZERO. 
EXEC SQL CLOSE C1 END-EXEC. 


GET-REST-OF-DEPT. 
EXEC SQL FETCH C1 INTO :DNUM, :DNAME, :MNUM END-EXEC. 
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GRANT 2 


The GRANT statement grants table and view privileges to users. 


Invocation 
This statement can be embedded In an application program or issued interactively. 
It is an executable statement that can be dynamically prepared. 


Authorization 
The privileges held by the authorization ID of the statement must include: 


e Every privilege specified, and ownership of the object, or 
e Every privilege specified, and the system authorities “OBJMGT and *OBJOPR 
on the table or view. 


To have every privilege you specify, you must: 


e Be the owner of the object. or 
e Have been granted the privileges. 


po ALL 


en tn 
ar a 
1 ne (a oS) 
INSERT 
SELECT 
UPDATE 
i. —q 


ee ea erage pb 
TABLE view-name 


| 


y 
OES 


L_pyBLIc—4 


Description 
ALL or ALL PRIVILEGES 
Grants all table privileges which you have for all tables or views named in the 
ON clause. Note that granting ALL PRIVILEGES on a table or view is not the 
same as granting the system authority of *ALL. 


If you do not use ALL, you must use one or more of the keywords in the 
following list. 


Each keyword grants the privilege described, but only to the table or view 4 
named in the ON clause. J 
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Usage Notes 


GRANT 


Keyword Grants the privilege to ... 
DELETE Usethe DELETE statement. 


INDEX Use the CREATE INDEX statement. Views may not be specified 
when granting INDEX authority. 


INSERT Use the INSERT statement. 
SELECT Use the SELECT statement. 
UPDATE Use the UPDATE statement. 


ON or ON TABLE 
table-name and view-name name the table or view on which you are granting 
the privileges. 


TO 
Indicates to whom the privileges are granted. 


auth-id 
Lists one or more authorization IDs. 


PUBLIC 
Grants the privileges to all users that have no privately granted privilege. 


Because the GRANT and REVOKE statements assign and remove AS/400 system 
security authorities for SQL objects, each SQL privilege can be said to correspond 
to specific AS/400 system rights. The tables that follow outline this 
correspondence; the left column lists all grantable SQL privileges, and the right 
columns list the equivalent AS/400 system object and data rights for views and for 
tables. System data rights are assigned to and removed from either the table 
specified or, if a view is specified, to the base table or tables on which the view is 
specified and on which the view is dependent. 


Corresponding AS/400 System Rights 
When Granting to a Table 


“OBJMGT 


SQL Privilege 
ALL (GRANT 


of ALL only *“OBJOPR 
grants those “ADD 
privileges *DLT 
you currently | “READ 
have) *“UPD 
DELETE *“OBJOPR 
“DELETE 
INDEX *“OBJMGT 
INSERT “OBJOPR 
*ADD 
SELECT "“OBJOPR 
“READ 


UPDATE “OBJOPR 
“UPD 


Figure 3. Privileges Granted to Tables 
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Corresponding AS/400 System | Corresponding AS/400 System 
SQL Privilege | Rights Granted to View Rights Granted to Base Table 


ALL (GRANT *“OBJOPR *ADD 
of ALL only 
grants those 
privileges 
you currently 
have) 


DELETE “OBJOPR 


INDEX N/A 


| INSERT “OBJOPR | “ADD | 


SELECT *“OBJOPR *READ 


Figure 4. Privileges Granted to Views 


If a view is read-only, only the SQL authority of SELECT can be granted on it. If 
inserts are not allowed on a view, the SQL authority of INSERT cannot be granted 
on it. 


Example 1: Grant SELECT privileges on table CORPDATA.EMP to user PULASKI. 


GRANT SELECT 
ON CORPDATA. EMP 
TO PULASKI 


c INCLUDE 


The INCLUDE statement inserts declarations into a source program. 


Invocation 
This statement can only be embedded in an application program. It is not an 


executable statement. 


Authorization 
None required. 


SQLCA 
ee a | a ee 


L___nember-name— 


Description 

SQLCA 
Indicates the description of an SQL Communication Area (SQLCA) is to be 
included. INCLUDE SQLCA must not be specified more than once in the same 
program. 
SQLCA must be specified for COBOL and PL/I. It cannot be specified for RPG. 

ie See Appendix B, “SQLCA and SQLDA Control Blocks” on page 119, for a 

description of the SQLCA. 

SQLDA 


Indicates the description of an SQL Descriptor Area (SQLDA) is to be included. 
It must not be specified in a COBOL or RPG program. 


See Appendix B, “SQLCA and SQLDA Control Blocks” on page 119, for a 
description of the SQLDA. 


member-name 
Names a member to be included from the file specified on the INCFILE 
keyword of the CRTSQLxxx (where xxx is RPG, CBL or PLI) command. 


The member may contain any host language source statements and any SQL 
Statements other than an INCLUDE statement. 


Usage Notes 
When your program is precompiled, the INCLUDE statement is replaced by source 
Statements. Thus, the INCLUDE statement should be specified at a point in your 
program such that the resulting source statements are acceptable to the compiler. 


Example 
Include an SQLCA in a program. 


EXEC SQL INCLUDE SQLCA END-EXEC. 
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INSERT 


Invocation 


Authorization 


The INSERT statement inserts rows into a table or view. Inserting a row into a 
view inserts the row into the table on which the view Is based. 


This statement can be embedded in an application program or issued interactively 
It is an executable statement that can be dynamically prepared. 


The privileges held by the authorization |D of the statement must include the 
INSERT privilege on the specified table or view. 


You have the INSERT privilege on a table if any of the following apply: 


e You are the owner of the table. 

e You have been granted the INSERT privilege on the table. 

e You have been granted the system authorities *“OBJOPR and *ADD on the 
table. 


You have the INSERT privilege on a view if any of the following apply: 


e You have been granted the INSERT privilege on the view. 

e You created the view, you had the INSERT privilege on its base table at that 
time, and you still have that INSERT privilege. 

e You have been granted the system authorities “OBJOPR and *ADD on the base 
table. 


If a Subselect is specified, the privileges held by the authorization ID of the 
Statement must also include the SELECT privilege on every table or view identified 
in the subselect. Refer to SELECT to determine when you have the SELECT 
privilege. 


p>>——INSERT INTO oF fis as 
vi aie | ca eee 


ees | 
| '_snecial—-register— | | 
subselect | 
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constant ) 
host-variable | 


Note: Refer to Chapter 4, “Queries” on page 39 for syntax of subselect. 


< 


© 


Description 


INSERT 


INTO tabie-name or view-name 


Names the table or view into which you want to insert. It must be described in 
the catalog. but must not be a catalog table or any of the following types of 
view: 


e A read-only view (for a description, see “CREATE VIEW” on page 66) 
e A view of a catalog table 


The following types of views are not allowed unless a column name has been 
specified: 


e A view with a column that is derived from a constant or an arithmetic 
expression 


® A view with two columns derived from the same column of the underlying 
table. 


column-name 


Lists the names of one or more columns for which you provide insert values. 
You may name the columns in any order. Each must belong to the table or 
view named. and you may not name the same column more than once. The 
column names must not be qualified. 


If you omit the column list, you are implicitly using a list of all the columns, in 
the order they exist in the table or view. 


The implicit column list is established at create program time if the referenced 
table or view exists at create program time. Otherwise, the implicit column list 
is established at the first successful run of the INSERT statement. Hence an 
INSERT statement embedded in an application program does not use any 
columns that might have been added to the table or view after create program 
time. 


VALUES 


Introduces one row of values to be inserted. The values of the row are the 
values of the keywords, constants, or host variables specified in the clause. 


Each host variable you name must be described in your program in 
accordance with the rules for declaring host variables. 


The number of values in the VALUES clause must equal the number of names 
in the column list. The first value is inserted in the first column in the list, the 
second value in the second column, and so on. 


see Chapter 2, “Language Elements” on page 7 for an explanation of 
constant and host-variable. See “Special Registers’ on page 18 fora 
description of special-register. 


subselect 


Inserts the rows of the result table of a subselect. There may be one, more 
than one, or none. If there are none, SQLCODE is set to +100. 


The base object of the INSERT, and the base object of the subselect, must not 
be the same table. 


The number of columns in the result table must equal the number of names in 
the column list. The value of the first column of the result is inserted in the first 
column in the list, the second value in the second column, and so on. 
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INSERT 


Insert Rules 


Usage Notes 


Examples 
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A maximum of 4096 rows may be inserted in any single INSERT operation when i» 
COMMIT(*ALL) or COMMIT({*CHG) has been specified. 


Insert values must satisfy the following rules. If they do not, or if any other errors 
occur during the execution of the INSERT statement, no rows are inserted. 


Default values: The value inserted in any column, not inthe column list, is the 
default value of the column. Columns without a default value must be included in 
the column list. Similarly, if you insert into a view, the default value is inserted into 
any column of the base table that is not included in the view. Hence all columns of 
the base table that are not in the view must have default values. 


Data Types: The data type of the values to be inserted must be compatible with the 
data type defined for the corresponding columns. 


Length: If the insert value of a column is a number, the column must be a numeric 
column with the capacity to represent the integral part of the number. If the insert 
value of a column is a string, the column must be a string column with a length 
attribute at least as great as the !ength of the string. 


Assignment: Insert values are assigned to columns in accordance with the 
assignment rules described in Chapter 2. 


Validity: |f the table named, or the base table of the view named, has one or more 
unique indexes, each row inserted into the table must conform to the constraints 
imposed by those indexes. ) 


An INSERT statement may be used to insert rows that do not conform to the 
definition of the view. These rows will not appear in the view, but are inserted into 
the base table of the view. 


If an error occurs during the execution of an INSERT statement and COMMIT(*ALL) 
or COMMIT{*CHG) was specified. all changes made during the execution of the 
statement are backed out. However, other changes in the unit of recovery made 
prior to the error are not backed out. If COMMIT(*NONE) is specified, changes are 
not backed out. 


One or more exclusive locks are acquired at the execution of a successful INSERT 
statement. Until the locks are released, an inserted row can only be accessed by 
the application process that performed the insert. For further information about 
locking, see the description of the COMMIT, ROLLBACK, and LOCK TABLE 
statements. 


Example 7: Insert values into table CORPDATA.E MP. 


INSERT INTO CORPDATA. EMP 
VALUES ('000205', 'MARY','T', 'SMITH', 'D11', '2866', 
810810,42,16, 'F',550522, 16345) 


Example 2: Load the temporary table SMITH. TEMPEMPL with data from table 
CORPDATA.EMP. ( j 


INSERT 


INSERT INTO SMITH. TEMPEMPL 
SELECT * 
FROM CORPDATA. EMP 


Example 3: Load the temporary table SMITH. TEMPEMPL with data from 
Department D11 from CORPDATA.EMP. 


INSERT INTO SMITH. TEMPEMPL 
SELECT * 
FROM CORPDATA. EMP 
WHERE WORKDEPT='D11! 
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LABEL ON J 


The LABEL ON statement adds or replaces labels in the catalog descriptions of 
tables, views, or columns. 


Invocation 
This statement can be embedded in an application program or issued interactively. 


It is an executable statement that can be dynamically prepared. 


Authorization 
The privileges held by the authorization ID of the statement must include: 


e The system authority *READ on the library containing the table or view, and 
¢ Ownership of the table or view, or the system authorities of both “OBJOPR and 
*“OBJMGT on the referenced table or view. 


>>——| ABEL ON 


vere eee e—name IS string-constant 
| fe 


tia oe Eee name.col umn—- re 
view-name.column-name 


ae 7 
umn—name IS string- conan 


tabi'e=name-—-4>-—=— ("Co | 
vj ew-name——! >" 


Description 
TABLE 
Indicates that the label is for a table or a view. Labels on tables or views are 
implemented as AS/400 system object text. 


table-name or view-name 
Must identify a table or view described in the catalog. 


COLUMN 
Indicates that the label is for a column. Labels on columns are implemented 
as AS/400 system column headings, and can therefore be used when 
displaying or printing query results. 


table-name.column-name or view-name.column-name 
Is the name of the column, qualified by the name of the table or view in 
which it appears. The column named must be described in the catalog. 


Introduces the label you want to provide. 


string-constant 
Can be any SQL character string constant of up to 30 bytes in length for 
tables and views, or 20 bytes in length for columns. The constant may 
contain double-byte characters as well as EBCDIC characters. (Q 
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( Example 
Enter a label on the DEPTNO column of table CORPDATA.TDEPT. 


LABEL ON COLUMN CORPDATA. TDEPT.DEPTNO 
TS 'DEPARTMENT NUMBER’ 
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LOCK TABLE 


Invocation 


Authorization 


The LOCK TABLE statement acquires a shared or exclusive lock on the named 
table. 


This statement can be embedded in an application program or issued interactively. 
It is an executable statement that can be dynamically prepared. 


The privileges held by the authorization ID of the statement must include: 


¢ Ownership of the table, or 
e Any SQL privilege for the table, or 
e The system authority “OBJOPR on the table. 


>>——LOCK TABLE table-name IN————SHARE———_ 00 _——_________1_______+>« 


L__eyc_usive— 


Description 
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fable-name 
Names the table to be locked. The table must be a base table described in the , ) 
catalog, but not a catalog table. 


IN SHARE MODE 
Acquires a shared lock (“SHRNUP) for the application process in which the 
statement is executed. The lock prevents concurrent application processes 
from executing any but read-only operations on the named table. 


IN EXCLUSIVE MODE 
Acquires an exclusive lock (*EXCL) for the application process in which the 
statement is executed. The lock prevents concurrent application processes 
from executing any operations at all on the identified table. 


The lock is acquired when the LOCK TABLE statement is executed. 


It is released by the termination of the unit of recovery unless the unit of recovery 
is terminated by a COMMIT HOLD or ROLLBACK HOLD. It is also released when 
the first SQL program in the program stack ends. You may also issue the CL 
command DLCOBJ to unlock the table. 


Because the statement is synchronous, conflicting locks already held by other 
application processes will cause your application to wait up to the default wait 
time. 


LOCK TABLE 


< Example 
Obtain a lock on the table CORPDATA.EMP. Do not allow other programs either to 
read or update the table. 


LOCK TABLE CORPDATA.EHP IN EXCLUSIVE MODE 
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OPEN | 


The OPEN statement opens a cursor so that it can be used to fetch rows from its 


result table. 
Invocation 
This statement can only be embedded in an application program. It is an 
executable statement that cannot be dynamically prepared. 
Authorization 


See “DECLARE CURSOR” on page 68 for an explanation of the authorization 
required to use a cursor. 


>>—-QOPEN cursor—name 


J 


USING—host-variab] ea 
USING DESCRIPTOR descriptor—name 


Description 


cursor-name 
Identifies the cursor to be opened. The cursor-name must identify a declared J 
cursor as explained in the Usage Notes for the DECLARE CURSOR statement. 
When the OPEN statement is executed. the cursor must be in the closed state. 


The SELECT statement associated with the cursor is either: 
e the SELECT statement specified in the DECLARE CURSOR statement, or 


e the prepared se/ect-statement identified by the statement-name specified 
in the DECLARE CURSOR statement. If the identified SELECT statement 
has not been successfully prepared, the cursor cannot be successfully 
opened. 


The result table of the cursor is derived by evaluating the SELECT statement. 
The evaluation uses the current values of any special registers specified in the 
SELECT statement and the current values of any host variables specified in the 
SELECT statement or the USING clause of the OPEN statement. The rows of 
the result table may be derived during the execution of the OPEN statement, 
and a temporary table created to hold them: or they may be derived during the 
execution of subsequent FETCH statements. In either case, the cursor is 
placed in the open state and positioned before the first row of its result table. 

If the table is empty, the state of the cursor is effectively “after the last row.” 


USING 
Introduces a list of host variables whose values are substituted for the 
parameter markers (question marks) of a prepared statement. (See 
“PREPARE” on page 101 for an explanation of parameter markers.) If the 
DECLARE CURSOR statement names a prepared statement that includes 
parameter markers, you must use USING. If the prepared statement does not ( 
include parameter markers, USING is ignored. - | 


98 SQL/400 Reference 


Usage Notes 


OPEN 


host-variable 
Identifies a variable described in the program in accordance with the rules 
for declaring host variables. The number of variables must be the same as 
the number of parameter markers in the prepared statement. The nth 
variable corresponds to the nth parameter marker in the prepared 
statement. 


USING DESCRIPTOR descriptor-name 
Identifies an SQLDA that must contain a valid description of host variables. 
The number of variables, as indicated by SQLD, must be the same as the 
number of parameter markers in the prepared statement and the length of 
the SQLDA, as indicated by SQLDABC, must be sufficient to describe that 
number of variables. The nth variable described by the SQLDA 
corresponds to the nth parameter marker in the prepared statement. Note 
that because RPG and COBOL do not provide the facility for setting 
pointers, and the SQLDA uses pointers to locate the appropriate host 
variables, you will have to set these pointers outside your RPG or COBOL 
application. (For a description of an SQLDA, see Appendix B, “SQLCA 
and SQLDA Control Blocks” on page 119.) 


When the SELECT statement of the cursor is evaluated, each parameter marker is 
effectively replaced by the value of its corresponding host variable. Each value 
that replaces a parameter marker must be compatible with operations applied to it 
during the execution of the prepared statement. For example, 


e lf aparameter marker appears as the operand of an arithmetic operator, its 
value is converted to conform to the description of the other operand, if 
necessary, according to the rules described in Chapter 2. 


e [f the other operand is a column, the value of the parameter is the number that 
would result if the host variable were assigned to the column, and the value 
must conform to the rules for assignments described in Chapter 2. 


e lf a parameter value is used as the operand of a comparison operator. it must 
be compatible with the other operand of that operator, and its length must not 
be greater than that of the other operand. In the case of the BETWEEN and IN 
predicates, this “other operand” is the first operand that is not specified with a 
parameter marker. 


Closed state of cursors: All cursors in a program are in the closed state when: 


e The program is initiated 
e A program initiates a new unit of recovery by executing a COMMIT or 
ROLLBACK statement without a HOLD option. 


A cursor can also be in the closed state because a CLOSE statement was 
executed. 


To retrieve rows from the result table of a cursor, you must execute a FETCH 
statement when the cursor is open. The only way to change the state of a cursor 
from closed to open is to execute an OPEN statement. 


Effect of temporary tables: |f the result table of a cursor is not read-only, its rows 
are derived during the execution of subsequent FETCH statements. The same 
method may be used for a read-only result table. However, if a result table is 
read-only, the data base manager may choose to use the temporary table method 
instead. With this method, the entire result table is materialized in a temporary 
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OPEN 


table during the execution of the OPEN statement. When a temporary table is 
used, the results of a program can differ in these two ways: eS) 


e An error can occur during OPEN that would otherwise not occur until some 
later FETCH statement. 


e The INSERT, UPDATE, and DELETE statements are not allowed while the 
cursor iS open. 


Conversely, if a temporary table is not used, INSERT, UPDATE. and DELETE 
statements executed while the cursor is open can affect the result table if issued 
from the same program. Your result table can also be affected by operations 
executed by your own unit of recovery, and the effect of such operations is not 
always predictable. For example, if cursor C is positioned on a row of its result 
table defined as SELECT * FROM T, and you insert a row into T, the effect of that 
insert on the result table is not predictable because its rows are not ordered. 
Thus, a subsequent FETCH C may or may not retrieve the new row of T. 


Example 
The OPEN statement places the cursor at the beginning of the rows to be fetched. 


EXEC SQL DECLARE C1 CURSOR FOR 
SELECT DEPTNO, DEPTNAME, MGRNO FROM CORPDATA.TDEPT 
WHERE ADMRDEPT = ‘AGO! 
END-EXEC. 


EXEC SQL OPEN Cl END-EXEC. 
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PREPARE 


The PREPARE statement is used by application programs to dynamically prepare 
an SQL statement for execution. The PREPARE statement creates an executable 
SQL statement, called a prepared statement, from a character string form of the 
statement, called a statement string. The life of a prepared statement extends to 
one of the following. 


e The end of the application program, or 

e Until another PREPARE statement with the same statement name has been 
issued by the same instance of the program in the program stack (in the case 
of recursive program calls), or 

e Until a COMMIT (no HOLD), or ROLLBACK (no HOLD) is issued. 


Invocation 
This statement can only be embedded in an application program. It is an 


executable statement that cannot be dynamically prepared. 


Authorization 
The authorization rules are those defined for the dynamic preparation of the SQL 
statement specified by the PREPARE statement. For example, see 
Chapter 4, “Queries” on page 39 for the authorization rules that apply when a 
SELECT statement is prepared. 


Authorization is not completely checked when DROP DATABASE, DROP TABLE or 
DROP VIEW statements are prepared. The system authority *OBJEXIST on all 
objects in the data base is not required to prepare a DROP DATABASE statement. 
The system authority “OBJEXIST is not required on all views, indexes, and logical 
files that reference the table in a DROP TABLE statement. The system authority of 
*OBJEXIST is not required on all views that reference the view in a DROP VIEW 
Statement. The *OBJEXIST authority will be checked when the statement is 
executed via the EXECUTE statement. 


m>>——PREPARE statement—name 


L_INTO descriptor-—name 


>——F ROM | — 
We Ge 


Description 
stafement-name 
Names the prepared statement. If the name identifies an existing prepared 
Statement, that prepared statement is destroyed, unless the statement is 
prepared in another instance of the same program or another program. The 
name must not identify a prepared statement that is the SELECT statement of 
an open cursor of this instance of the program. 
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INTO 


If you use INTO and the PREPARE statement is successfully executed, 
information about the prepared statement is placed in the SQLDA specified by 
the descriptor-name. Thus, the PREPARE statement: 


EXEC SQL PREPARE S1 INTO SQLDA FROM V1; 


is equivalent to: 


EXEC SQL PREPARE S1 FROM V1; 
EXEC SQL DESCRIBE S1 INTO SQLDA; 


See “DESCRIBE” on page 75 for an explanation of the information that is 
placed in the SQLDA. 


descriptor-name 
Is SQLDA or the name of an SQLDA. 


USING 
Indicates what value to assign to each SQLNAME variable in the SQLDA 
when INTO is used. If the requested value does not exist, SQLNAME is set 
to length O. 


NAMES 
Assigns the name of the column. The default is USING NAMES. 


LABELS 
Assigns the label of the column. (Column labels are defined by the 
LABEL ON statement.) 


ANY 
Assigns the column label, and, if the column has no label, the column 


name. 


BOTH 
Assigns both the label and name of the column. In this case, two 
occurrences of SQLVAR per column will be needed to accommodate 
the additional information. To specify this expansion of the SQLVAR 
array, set SQLN to 2*n on the PREPARE statement (where n is the 
number of columns in the result table). Then, on any later FETCH 
statement, set SQLN ton. The first n occurrences of SQLVAR for each 
of the columns in the result table contain the column names. The 
second n occurrences contain the column labels. 


FROM 
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Introduces the statement string. The statement string is the value of the 
specified string-expression or the identified host variable. 


string-expression 
Is any expression that yields a character string. String expressions are not 
allowed in RPG or COBOL. 


host-variable 
Must identify a host variable that is described in the program in 
accordance with the rules for declaring character string variables. 


The host variable must be of the form :host-variable. The form 
shost-variable:indicator-variable is not allowed. 


e 


C 


Usage Notes 


PREPARE 


Rules for statement strings: The statement string must be one of the following SQL 
statements: COMMENT ON, COMMIT, CREATE DATABASE, CREATE INDEX, 
CREATE TABLE, CREATE VIEW, DELETE, DROP, GRANT, INSERT, LABEL ON, 
LOCK TABLE, REVOKE, ROLLBACK, or UPDATE. 


The statement string may also be a Se/ect-statement. For information on the 
select-statement, see “select-statement” on page 4/7. 


Furthermore, the statement string must not: 


e Begin with EXEC SQL and end with a statement terminator 
® Include references to host variables 
e Include comments. 


Parameter markers: Although a statement string cannot include references to host 
variables, it may include parameter markers; those can be replaced by the values 
of host variables when the prepared statement is executed. A parameter marker is 
a question mark (?) that appears where a host variable could appear if the 
statement string were a static SQL statement. For an explanation of how 
parameter markers are replaced by values, see “OPEN” on page 98 and 
“EXECUTE” on page 80. 


Rules for parameter markers 
e Parameter markers must not appear: 
— Inaselect list (SELECT ? is invalid) 
— As an operand of the concatenation or substring operator 


— As both operands of a single arithmetic or comparison operator (WHERE ? 
= ? is invalid) 


— As anoperand of a unary minus 


e At least one of the operands of the BETWEEN or IN predicates must not be a 
parameter marker. 


* If ascalar function is used in other than a SELECT list, and it has an argument 
that can be specified as an arithmetic expression, a parameter marker can be 
included in that expression, provided that it is the operand of an arithmetic 
operator and that the other operand is a number. 


When a PREPARE statement is executed, the statement string is parsed and 
checked for errors. If the statement string is invalid, a prepared statement is not 
created and a negative value is returned in the SQLCODE field of the SQLCA. 


Prepared statements can be referred to in the following kinds of statements, with 
the restrictions shown: 


In... The prepared statement ... 
DESCRIBE has no restrictions 
DECLARE CURSOR’ must be SELECT 
EXECUTE must not be SELECT 


A prepared statement can be executed many times. Indeed, if a prepared 
statement is not executed more than once and does not contain parameter 
markers, it is more efficient to use the EXECUTE IMMEDIATE statement, rather 
than the PREPARE and EXECUTE statements. 
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All prepared statements created by a unit of recovery are destroyed when the unit | } 
of recovery is terminated, unless COMMIT HOLD or ROLLBACK HOLD was used. 


A prepared statement can only be referenced in the same instance of the program 
in the program stack. 


Example 
In this example, an INSERT statement with parameter markers is prepared. 


MOVE 'INSERT INTO CORPDATA.QUOTATIONS VALUES(?,?,?,?)' TO HOLDER. 


EXEC SQL PREPARE QUOTES FROM :HOLDER END-EXEC. 
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SS REVOKE 


The REVOKE statement removes privileges on tables and views from users. 


Invocation 
This statement can be embedded in an application program or issued interactively. 
It is an executable statement that can be dynamically prepared. 


Authorization 
The privileges held by the authorization ID of the statement must include “OBJMGT 
authority and the privileges you are revoking. 


po ALL 


SSS 
—— —_ 
i 


1 NDEX————— 
SS 6 ST 
Se 


UPDATE 


| » ] | 
v 
ee’ TABLE view-name 


[ 3 


y 
PERO ae 
— Lpatic 


Description 
ALL cr ALL PRIVILEGES 
Revokes all table privileges {listed below) for the specified tables or views. 
If you do not use ALL, you must use one or more of the keywords in the 
following list. Each keyword revokes the privilege described. but only as it 
applies to the tables or views named in the ON clause For information on how 
these privileges relate to the AS/400 system object and data rights, see “Usage 
Notes” on page 8/7. 
Keyword Revokes the privilege to ... 
DELETE Use the DELETE statement. 
INDEX Use the CREATE INDEX statement. 
INSERT Use the INSERT statement. 
. SELECT Use the SELECT statement. 
SS UPDATE Use the UPDATE statement. 
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ON or ON TABLE 
Introduces a list of table and view names. 2 


The table-name and view-name name one or more tables or views on which 
you are revoking the privileges. The list may be a list of table names, view 
names, or a combination of the two. 


FROM 
Identifies from whom the privileges are revoked. 


auth-id 
Lists one or more auth-ids. Do not use the same auth-id more than once. 


PUBLIC 
Revokes a grant of privileges to PUBLIC. 


Usage Notes 
System Object and Data Rights: When revoking authorities to a table, the 
*OBJOPR object rights are revoked only when all system data rights to that table 
have been revoked. For a view, these system object rights will only be revoked 
when all system data rights to the table or tables on which the view is dependent 
have been revoked. 


When revoking authorities to a view, the system data rights will only be revoked 
from a base table if the specified user does not have the system authority of 
*“OBJOPR to the base table or to any other view dependent on the base table. 


Read-only Views. \|f inserts. updates. or deletes are not allowed on a view, then the 
respective SQL authority of INSERT, UPDATE. or DELETE cannot be revoked from ) 
the view. 


Multiple grants: |f you granted the same privilege to the same user more than 
once, revoking that privilege from that user nullifies all those grants. 


Examples 
Example 1: Revoke SELECT privileges on table CORPDATA.EMP from user 


PULASKI. 
REVOKE SELECT 


ON TABLE CORPDATA. TEMPL 
FROM PULASKI 


Example 2: Revoke update privileges on table CORPDATA.EMP, previously 
granted to all users. Note that grants to specific users are not affected. 


REVOKE UPDATE ON TABLE CORPDATA. TEMPL 
FROM PUBLIC 


Example 3: Revoke all privileges on table CORPDATA.EMP. from users KWAN and 
THOMPSON. 


REVOKE ALL 
ON TABLE CORPDATA. TEMPL 
FROM KWAN, THOMPSON 
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ROLLBACK 


Invocation 


Authorization 


The ROLLBACK statement is used to terminate a unit of recovery and back out the 
data base changes that were made by that unit of recovery. 


This statement can be embedded in an application program or it can be issued 
interactively. It is an executable statement that can be dynamically prepared. 


None required. 


> 


r>——ROLLBACK 


Description 


Usage Notes 


LC woRK————— ss +0 _LD- 


The unit of recovery in which the ROLLBACK statement is executed is terminated 
and a new unit of recovery is initiated. All changes made by INSERT, UPDATE, and 
DELETE statements executed during the unit of recovery are backed out. 


All locks acquired by the unit of recovery are released. All cursors that were 
opened during the unit of recovery are closed. All statements that were prepared 
during the unit of recovery are destroyed, and any cursors associated with the 
prepared statements are invalidated. 


‘WORK 


ROLLBACK WORK has the same effect as ROLLBACK. SQL/400 accepts the 
keyword WORK for compatibility with other data base products. 


HOLD 
Indicates a hold on resources. If specified, currently open cursors are not 
closed, prepared SQL statements are preserved, and all resources acquired 
during the unit of recovery, except locks on the rows of tables, are held. Locks 
on specific rows acquired during the transaction, however, are released. If 
HOLD is omitted, open cursors are closed, prepared SQL statements 
discarded, and held resources released. At the end of a ROLLBACK, the 
cursor position is the same as it was at the start of the unit of recovery. 


A unit of recovery (see “Application Processes, Concurrency, and Recovery” on 
page 5 for description) may include the processing of up to 4096 rows, including 
rows retrieved during a SELECT or FETCH statement’, and rows inserted, deleted, 
or updated as part of INSERT, DELETE, and UPDATE operations.5 The commit and 
rollback operations do not affect any data definition statements. and these 


4 Unless you specified COMMIT(*CHG), in which case these rows are not included in this 
total. 


5 This limit also includes any records accessed or changed through files opened under 
commitment control through high-level language file processing. 
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ROLLBACK 


Example 
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statements are not, therefore, allowed in an application program that also specifies om 
COMMIT(*CHG) or COMMIT(*ALL). The data definition statements are: 7 
COMMENT 

CREATE DATABASE 

CREATE INDEX 

CREATE TABLE 

CREATE VIEW 

DROP DATABASE 

DROP INDEX 

DROP TABLE 

DROP VIEW 

GRANT 

LABEL 

REVOKE 


Commitment control is implicitly started by SQL, if necessary, using the system CL 
command STRCMTCTL. The lock level used is based on the COMMIT option 
specified on either the CRTSQLxxx (where xxx is RPG, CBL or PLI) or the STRSQL 
command. 


A ROLLBACK is automatically performed when: 
1. An application process ends without a final COMMIT being issued. 
2. A failure occurs that prevents the application from completing its work (such as 


a power failure). 


If a CLOSE was issued within a unit of work. and a ROLLBACK is subsequently 
issued, all other changes are backed out. but the CLOSE itself is not backed out: 
the file is not reopened. 


Delete the alterations made since the last commit point or rollback. 
ROLLBACK WORK 


Cc SELECT INTO 


The SELECT INTO statement produces a result table consisting of at most one row, 
and assigns the values in that row to host variables. If the table is empty, the 
statement assigns +100 to SQLCODE and does not assign values to the host 


variables. 

Invocation 
The SELECT INTO statement can only be embedded in an application program. It 
is an executable statement that cannot be dynamically prepared. 

Authorization 


To use SELECT, the privileges held by the authorization ID of the statement must 
include the SELECT privilege on every table and view identified in the statement. 


You have the SELECT privilege on a table if any of the following apply: 


e You are the owner ofthe table 
e You have been granted the SELECT privilege on the table 


e You have been granted the system authorities “OBJOPR and “READ on the 
table. 


You have the SELECT privilege on a view if any of the following apply: 


e You have been granted the SELECT privilege on the view 

e You created the view. you had the SELECT privilege on its base table when the 

— view was created, and you still have that SELECT privilege 

e You have been granted the system authority “OBJOPR on the view and the 
system authority “READ on the base table. 


treme 
>>—select-clause——INTO host-variable 


f rom-c 1 ause——_, ——+> 
l_where-clause— 


re epee oath = ~~ 


Description 
See Chapter 4, “Queries” on page 39 for information on the se/ect-clause, 
from-clause, where-clause, grouping-clause, and having-clause. Note that the 
from-clause must not identify a view that includes a grouping-clause or a 
having-clause. Note too that the grouping, as specified by the grouping-clause, 
strongly implies a result table of more than one row, and that a having-clause is 
probably needed to reduce the table to at most one row. 


INTO 
Introduces a list of host variables. 
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Examples 


host variable 


Names a Structure or variable that is described in the program under the 
rules for declaring host structures and variables. A reference toa 
structure is replaced by areference to each of its variables before the 
statement is executed. 


The first value in the result row is assigned to the first variable in the list, 
the second value to the second variable, and soon. !If the number of host 
variables is less than the number of column values, the value 'W' is 
assigned to the SQLWARNS field of the SQLCA. 


The data type of a variable must be compatible with the value assigned to 
it. If the value is numeric, the variable must have the capacity to represent 
the integral part of the value. If the value is null, an indicator variable must 
be specified. 


Each assignment to a variable is made according to the rules described in 
Chapter 2, “Language Elements.” Assignments are made in sequence 
through the list. 


lf an error occurs as the result of an arithmetic expression in the SELECT 
list of a SELECT statement (division by zero, or overflow) or a numeric 
conversion error occurs, the result is the null value. As in any other case 
of a null value, an indicator variable must be provided and the main 
variable is unchanged. Now, however, the indicator variable is set to -2. 
Processing of the statement continues as if the error had not occurred. If 
you provide no indicator variable, or some other type of error occurs, 
processing of the statement terminates when the error is met. 


If an error occurs. no value ts assigned to the host variable or to later 
variables. though any values that have already been assigned to variables 
remain assigned. 


If an error occurs because the result table has more than one row, values 
are assigned to all host variables, but the row that is the source of the 
values is undefined and not predictable. 


Example 1: Put the maximum salary in CORPDATA.EMP into the host variable 
MAXSALRY. 


EXEC SQL SELECT MAX (SALARY) 


INTO :MAXSALRY 
FROM CORPDATA. EMP; 


Example 2: Put the row for employee 528671, fram CORPDATA.EMP, into the host 
structure EMPREC. 


EXEC SQL SELECT * INTO :EMPREC 


FROM CORPDATA. EMP 
WHERE EMPNO = '528671' 


END-EXEC. 
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UPDATE 


The UPDATE statement updates the values of specified columns in rows of a table 
or view. Updating a row of a view updates a row of its base table. 


Invocation 


This statement can be embedded in an application program or issued interactively. 
It is an executable statement that can be dynamically prepared. 


Authorization 


The privileges held by the authorization ID of the statement must include the 
UPDATE privilege on the specified table or view. 


You have the UPDATE privilege on a table if any of the following apply: 


e You are the owner of the table. 

e You have been granted the UPDATE privilege on the table. 

e You have been granted the system authorities “OBJOPR and “UPD on the 
table. 


You have the UPDATE privilege on a view if any of the following apply: 


e You have been granted the UPDATE privilege on the view 

e You created the view, you had the UPDATE privilege on its base table at that 
time. and you still have that UPDATE privilege. 

e You have been granted the system authorities "OBJOPR and “UPD on the base 
table 


Searched Update 


p>——UPDATE 


la) <3 SSS SSS SS 
L_yjew-name—— L_corre]ation-name— 


ercqaeye Pra se na 


Positioned Update 


ee PALL Lab ead ——— et eee 
L—yiew-name—— 


(Se ee 


»>——SET—col umn—name=—-_——-—exx pres ee eee 


PERE CURRENT OE gS OS SSS SSS SS 
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Description ( ) 
table-name or view-name 


ls the name of the table or view you want to update. It must name a table or 
view described in the catalog, but not a catalog table, a view of a catalog table, 
or a read-only view. (See “CREATE VIEW’ on page 66 for an explanation of 
read-only views.) 


correlation-name 
May be used within search-condition to designate the table or view. (See 
“Correlation Names” on page 20 for an explanation of correlation-name.) 


SET 
Introduces a list of column names and «alues. 


The column names must not be qualified and the same column name must not 
be specified more than once. In a cursor-controlled update, each column name 
in the list must also appear in the FOR UPDATE OF clause of the SELECT 
statement of the identified cursor, unless FOR UPDATE OF and ORDER BY 
were not specified. 


column-name 
Identifies a column to be updated. The column-name must identify a 
column of the specified table or view but must not identify a view column 
derived from a scalar function, constant. or expression. 


expression 
Indicates the new value of the column The expression is any expression 
of the type described in Chapter 2 It must not include a column function. 
NULL specifies the null value. 


A column-name in an expression must name a column of the named table ed 
or view. For each row that is updated. the value of the column in the 
expression is the value of the column in the row before the row is updated. 


WHERE 
Introduces a condition that indicates what rows are updated. You can omit the 
clause, give a search condition, or name acursor. If you omit the clause, all 
rows of the table or view are updated 


search-conaition 
ls any search condition as described in Chapter 2. Each column-name in 
the search condition must name a column of the table or view. 


The search-condition is applied to each row of the table or view and the 
updated rows are those for which the result of the search-condition is true. 


CURRENT OF cursor-name 
Identifies the cursor to be used in the update operation. The cursor-name 
must identify a declared cursor as explained in the Usage Notes for 
“DECLARE CURSOR” on page 68 


The table or view named must also be named in the FROM clause of the 
SELECT statement of the cursor. and the result table of the cursor must not 
be read-only. (For an explanation of read-only result tables, see 
“DECLARE CURSOR” on page 68} 


When the UPDATE statement is executed. the cursor must be positioned on 
a row: that row is updated. 
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Usage Notes 
Cc A maximum of 4096 rows may be updated in any single UPDATE operation when 
COMMIT({*ALL) or COMMIT(*CHG) has been specified. 


Update values are assigned to columns under the assignment rules described in 


Chapter 2. 

If the update 

value is... Then the column must... 

A number Be a numeric column, with the capacity to represent 


the integral part of the number. 


A character string Be a character string column with a length attribute 
that is not less than the length of the string. 


If an update value violates any constraints, or if any other error occurs during the 
execution of the UPDATE statement, and COMMIT(*ALL) or COMMIT(*CHG) was 
specified, all changes made during the execution of the statement are backed out. 
However, other changes in the unit of recovery made prior to the error are not 
backed out. If COMMIT(*NONE) is specified, changes are not backed out. 


A view column derived from the same column as another column of the view can 
be updated, but both columns cannot be updated in the same UPDATE statement. 


When an embedded UPDATE statement completes execution, the value of 
SQLERRD(3) in the SQLCA is the number of rows updated. (For a description of 
the SQLCA, see Appendix B, “SQLCA and SQLDA Control Blocks” on page 119.) 


‘eer Unless appropriate locks already exist, one or more exclusive locks are acquired 
by the execution of a successful UPDATE statement. Until the locks are released, 
the updated row can only be accessed by the application process that performed 
the update. For further information on locking, see the descriptions of the 
COMMIT, ROLLBACK. and LOCK TABLE statements. 


Examples 
Example 1: Change employee 000190’s telephone number in CORPDATA.EMP. 


UPQATE CORPDATA.EMP 
SET PHONENO='3565! 
WHERE EMPNO='000196' 


Example 2: Increase the job code by 10 of members of Department D11. 


UPDATE CORPDATA. EHP 
SET JOBCODE = JCBCODE + 10 
WHERE WORKDEPT='D11' 


Example 3: Change the project end date for project number AD3111 to 13 July 
1984. 


UPDATE CORPDATA. PROJ 
SET PRENDATE = '1984-07-13! 
WHERE PROJNO = 'AD3111' 


Chapter 5. Statements 113 


WHENEVER J 


The WHENEVER statement specifies the host language label to which execution 
will be transferred when a specified exception condition occurs. 


Invocation 
This statement can only be embedded in an application program. It is not an 


executable statement. 


Authorization 
None required. 


NOT FOUND 
p> —IHENEVER SQLERROR——| CONTINUE 


L_—sgLWaRNING—I a a 
GO TO 


Description 
The SQLERROR, SQLWARNING, or NOT FOUND clause is used to identify the type 


of exception condition. 


SQLERROR 
Identifies any condition that results in a negative SQL return code. 


SQLWARNING J 
Identifies any condition that results in a warning condition (SQLWARNO is “W’). 
or that results in a positive SQL return code other than +100. 


NOT FOUND 
Identifies any condition that results in an SQL return code of +100. 


The CONTINUE or GO TO clause is used to specify what is to happen when the 
identified type of exception condition exists. 


CONTINUE 
specifies the next sequentia! statement of the source program. 


GOTO or GO TO host-label 
Specifies the statement identified by host-label. For host-iabel, substitute a 
single token, optionally preceded by a colon. The form of the token depends 
on the host language. In COBOL, for example, it can be a section-name or an 
unqualified paragraph-name. 


Usage Notes 
There are three types of WHENEVER statements. 


WHENEVER NOT FOUND 
WHE NEVER SQLERROR 
WHENEVER SQLWARNING 


Every executable SQL statement in a program is within the scope of one implicit or 

explicit WHENEVER statement of each type. The scope of a WHENEVER statement 

is related to the listing sequence of the statements in the program, not their ‘J 
execution sequence. | 
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WHENEVER 


An SQL statement is within the scope of the last WHENEVER statement of each 
type specified before that SQL statement in the source program. Ifa WHENEVER 
statement of some type is not specified before an SQL statement, that SQL 
statement is within the scope of an implicit WHENEVER statement of that type in 
which CONTINUE is specified. 


lf an error is produced, go to HANDLERR. If a warning code is produced, continue 
with the normal flow of the program. If no results are found, go to ENDDATA. 


EXEC SQL WHENEVER SQLERROR GOTO HANDLERR END-EXEC. 
EXEC SQL WHENEVER SQLWARNING CONTINUE END-EXEC. 
EXEC SQL WHENEVER NOT FOUND GO TO ENDDATA END-EXEC. 
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Appendix A. SQL Limits 


The table below describes certain limits imposed by SQL/400. The limits 
presented here are minimal values that. if used, will assist in making application 
programs readily portable from one system to another. 


ITEM SQL LIMIT | 


Most columns in atable 8000 


Most columns in a view | 8000 


Maximum length of a row, in bytes. 


including all overhead 


Maximum byte count of a row 32766 
Largest INTEGER value 2147483647 
Smallest INTEGER value -2147483648 
Largest SMALLINT value | 32767 
Smallest SMALLINT value | -32768 

Largest FLOAT value | Approximately 1.79E +308 


Smallest FLOAT value Approximately -1.79E + 308 
smallest positive FLOAT value Approximately 2.22E-308 


Largest negative FLOAT value Approximately -2.22E-308 
Largest REAL value | Approximately 3.40E +38 | 


smallest REAL value Approximately -3.40E + 38 


omaltest positive REAL value 
Larcest negative REAL value | Approximately -1.17E-38 

Largest DECIMAL value | 9999999999 999999999999999999999 

| Smallest DECIMAL value | -9999999999999999999999999999999 


Most table names in an SQL statement 32 
(In a complex SELECT, the number of | 
tables that can be joined may be | 
significantly less.) | 


Maximum length of a host variable 
name 


Figure 5 (Part 1 of 2). SQL Limits 
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Maximum total length of columns in an 296 
ORDER BY clause 


ITEM SQL LIMIT 


Most host variables in an SQL less than 40006 


Most host variables in a precompiled less than 40008 
program 


statement 

Maximum total length of host and storage 
indicator variables pointed to in an 

SQLDA 


Longest host variable used for insert or | 32/766 bytes 
update 


Longest SQL statement 32767 bytes 


Most elements in a select list less than 8000" 
Most functions in a select list less than 8000" 


Most predicates in a WHERE or less than 8000" 


Maximum total length of columns ina 120 


Maximum number of columns in an 120 


Figure 5 (Part 2 of 2). SQL Limits 


6 The limit is based on the number of pointers allowed in a program. Each host language 


~ 
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allows a different number of pointers. At a minimum, each host language uses one 
pointer for each use of a host variable. The AS/400 system allows a limit of 4040 
pointers in any program. 


The limit is based on the size of internal structures generated for the parsed SQL 
statements. 


c 


Appendix B. SQLCA and SQLDA Control Blocks 


This appendix describes the SQL communication area (SQLCA) and the SQL 
descriptor area (SQLDA). 


SQL Communication Area (SQLCA) 


An SQLCA is a collection of variables that is updated repeatedly during a program 
with information about the SQL statement most recently run. The SQL INCLUDE 
statement must be used to provide the declaration of the SQLCA in COBOL and 
PL/I. The SQLCA is provided for RPG by the SQL precompiler. 


In COBOL, the name of the storage area must be SQLCA. In PL/I, the name of the 
structure must be SQLCA. Every SQL statement must be within the scope of its 
declaration. 


Description of Fields 
The names in the following table are those provided by the SQL INCLUDE 
statement. For the most part, COBOL and PL/I use the same names. RPG names 
are different, because they are limited to 6 characters. Note one instance where 
PL/I names differ from COBOL. 
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COBOL, or RPG Data 
PL/I Name Name Type Descnption 
SQLDAID SQLAID CHAR(8) An “eye catcher” for storage dumps, containing 
'SQLCA '. 
SQLCABC SQLABC INTEGER Contains the length of the SQLCA, 136. 
(4-bytes) 
SQLCODE SQLCOD INTEGER Contains the SQL return code. 
Eebyies) Code Means 
¢) Successful execution (though there may have been 
warning messages). 
positive successful execution, but with an exception condition. 
negative Error condition. 
SQLERRML SQLERL SMALLINT Length indicator for SQLERRMC, in the range O through 70. O means 
(See Note) (2-bytes) that the value of SQLERRMC Is not pertinent. 
SQLERRMC SQLERM CHAR (70) Contains message replacement text associated with the SQLCODE. 
SQLERRP SQLERP CHAR(8) Provides diagnostic information, such as the name of a module. 
SQLERRD SQLERR Array 6 INTEGER variabies that provide diagnostic information. 
rag eae rtce SQLERRD(1} may contain the last four characters of the CPF 
characters (not an ; 
array) that are escape message if SQLCODE is Jess than 0. For example, if the 
redefined by the fields message |S CPF5715, X'F5F7F1F5' is placed in SQLERR[IX1). 
SQLER1 through SQLERRD(2} may contain the last four characters of a CPD 
SQLER6. The fields diagnostic message if the SQL code is less than 0. 
are full-word binary. ; 
SQLERRD(3) snows the number of rows affected after INSERT, 
UPDATE. and DELETE. 
Note: SQLERRD(1) and (2) are set only if appropriate. 
SQLWARN SQLWRN CHAR (8) A set of 8 warning indicators, each containing blank or “W.” 
Defined as 8 
characters (not an 
array). 
SQLWARNO SQLWNO CHAR(1} Blank if all other indicators are blank: contains “W” if at least one 
other indicator contains “W.” 
SQLWARN1 SQLWN1 CHAR(1)} Contains “W” if the value of a string column was truncated when 
assigned to a host variable. 
SQLWARN2 SQLWN2 CHAR(1) Reserved 
SQLWARN3 SQLWN3 CHAR(1) Contains “W” if the number of columns and the number of host 
variables are not the same. 
SQLWARN4 SQLWN4 CHAR(1) Contains “W” if a prepared UPDATE or DELETE statement does not 
Include a WHERE clause. 
SQLWARNS SQLWNS5 CHAR(1) Reserved 
SQLWARN6 SQLWNE6 CHAR(1) Reserved 
SQLWARN7 SQLWN7 CHAR(1) Reserved 
SQLEXT SQLEXT CHAR(8) Reserved 


Note: In COBOL. SQLERRM includes SQLERRML and SQLERRMC. In PL/I, the 
varying-length string SQLERRM is equivalent to SQLERRML prefixed to 
SQLERRMC. 
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The Included SQLCA 


The following is a description of the SQLCA that is given by INCLUDE SQLCA 


In COBOL: 


01 SOLCA. 
85 SQLCAID 
05 SQLCABC 
05 SQLCODE 
05 SQLERRM. 
49 SQLERRML 
49 SQLERRHC 
05 SQLERRP 
05 SQLERRD 


05 SQLWARN. 
10 SQLWARNO 
10 SQLWARNI 
10 SQLWARN2 
10 SQLWARN3 
10 SQLWARN4 
10 SQLWARNS 
10 SQLWARNG 
10 SQLWARNZ 

05 SQLEXT 


PIC X(8) 
PIC $9(9) COMP-4. 
PIC $9(9) COMP-4. 


PIC $9(4) COMP-4. 
PIC X(70). 

PIC X(8). 

OCCURS 6 TIMES 
PIC $9(9) COMP-4. 


PIC X(1) 
PIC X(1) 
PIC X(1) 
PIC x(1) 
PIC X(1) 
PIC X(1) 
PIC X(1) 
PIC X(1) 
PIC X(8) 


INCLUDE SQLCA must not be specified in other than the working storage section. 


In PL/I: 


DCL 1 SQLCA, 
2 SQLCAID 
SQLCABC 
SQLCODE 
SQLERRM 
SQLERRP 
SQLERRD (6) 
SQLWARN, 
3 SQLWARNG 
3 SQLWARN1 
3 SQLWARN2 
3 SQLWARN3 
3 SQLWARN4 
3 SQLWARNS 
3 
3 
S 


PO FO PM PM PO Po 


SQLWARNG 
SQLWARN? 
QLEXT 


CHAR (8), 

BIN FIXED(31), 
BIN FIXED(31), 
CHAR(70) VAR, 

CHAR (8) , 

BIN FIXED(31), 
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In RPG: The SQLCA data structure is generated by the SQL precompiler and is not 


specified by the user. 


ISQLCA DS 


mm ee eR OHH HOO tO OO a sO ea 


os] 


WwW wow ww w 


191 
105 
109 
113 
17 
12] 
12] 
122 
123 
124 
125 
126 
[27 
128 
129 


8 SQLAID 
120SQLABC 
160SQLCOD 
1€0SQLERL 
68 SQLERM 
96 SQLERP 

120 SQLERR 
iGQOSQLER1 
1940SQLER2 
1OS0SQLER3 
1120SQLER4 
L160SQLERS 
12CQSQLER6 
127 SQLWRN 
121 SQLWNO 
122 SQLWN1 
123 SQLYWN2 
124 SQLWN3 
125 SQLWN4 
126 SQLIWNS5 
l27 SQLINS 
128 SQLYN7 
13€ SQLEXT 


SQL 
SQL 
SQL 
SQL 
SQL 
SQL 
SQL 
SQL 
SQL 
SQL 
SQL 
SQL 
SQL 
SQL 
SQL 
SQL 
SQL 
SQL 
SQL 
SQL 
SQL 
SQL 
SQL 
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The SQL Descriptor Area (SQLDA) 


An SQLDA is a collection of variables that is required for execution of the SQL 
DESCRIBE statement, and may optionally be used by the PREPARE, OPEN, FETCH, 
and EXECUTE statements. An SQLDA communicates with dynamic SQL; it can be 
used in a DESCRIBE statement, modified with the addresses of host variables, and 
then reused in a FETCH statement. 


The meaning of the information in an SQLDA depends on its use. In PREPARE and 
DESCRIBE. an SQLDA provides information to an application program about a 
prepared statement. In OPEN, EXECUTE, and FETCH, an SQLDA provides 
information about host variables. 


Description of Fields 


PL/I 
Name 


SQLDAID 


SQLCA8C 


SQLN 
SQLD 


SOLVAR 


Data 

Type 
CHAR(8) 
INTEGER 
SMALLINT 


SMALL INT 


ARRAY 


The following description is based on the PL/I structure provided by the SQL 
INCLUDE statement. 


An SQLDA consists of four variables followed by an arbitrary number of 
occurrences of a sequence of five variables collectively named SQLVAR. In OPEN, 
FETCH, and EXECUTE, each occurrence of SQLVAR describes a host variable. In 
DESCRIBE and PREPARE, they describe columns of a result table. 


Usedin Used in FETCH, 
DESCRIBE and PREPARE OPEN, or EXECUTE 


An “eye catcher” for storage dumps, Not used. 


containing 'SQLDA 
SQLDABC must nave a value equal to or 


greater than SQLN*LENGTHI S@LVAR) prior to 
use by FETCH, CPEN. or EXECUTE. 


Length cf the SQLDA. equal to 
SQLN'LENGTH(SQLVAR) + 16. 


Total number of occurrences of SQLVAR. Same as usage in DESCRIBE and PREPARE. 


The number of host variables described by 
occurrences of SQLVAR. 


The number of columns described by 
occurrences of SQLVAR. 


Set of five fields. Not used. 
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Fields in an Occurrence of SQLVAR 


PL/I 
Name 


SQLTYPE 


SQLLEN 


SQLRES 


SQLDATA 


Data 
Type 


SMALLINT 


SMALLINT 


reservec area 
(12-byte} 


pointer 
(16-byte) 
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Usage in 
DESCRIBE and PREPARE 


Tells the data type of the column and whether 
or not it has an associated indicator variable. 
“Values of SQLTYPE” on page 126 lists the 
allowable values and their meanings. 


Gives the length attribute of the column, as 
follows. Also, see note in “Usage in FETCH, 
OPEN, and EXECUTE column. 


Data Type Content 


Character Length attribute in bytes. 


Decimal, Numeric, or Integer 
Byte 1 = precision; 
byte 2 = scale. 


Float 4 for single precision: 
8 for double precision. 


2 for SMALLINT; 
4 for INTEGER. 


Integer 


Note: 

Binary numbers may be represented in the 
SQLDA as either length of 2 or 4 or with 
precision and scale. Ifthe first byte 1s greater 
than X'Q0',7 it indicates precision and scale. 


Provides boundary aligiament. Pointers must 
be on a quad-word boundary. 


The first 4 bytes contain two smali integers 
and Indicate the SBCS character set and code 
page for a character column. The character 
set and code page are determined by the 
system value QCHRID. which is set by the 
user and contains both tne SBCS character 
set and code page identification. Ifthe 
integer is zero, either the column ts not 
character type, or the character is bit data 
(FOR BIT DATA). 


The remaining 12 bytes are reserved. 


Usage in FETCH, 
OPEN, and EXECUTE 


Same as usage in DESCRIBE and PREPARE. 


Same as usage in DESCRIBE and PREPARE. 


Same as usage in DESCRIBE and PREPARE. 


Specifies the address of the host variables. 


(continued) 


'S 


PL/I 
Name 


SQLIND 


SQLNAM 


Data 
Type 


pointer 
(16-byte) 


Varying length 

character string: 
maximum iength 
is 30 characters. 


Usage in 
DESCRIBE and PREPARE 


First 4 bytes are antnteger. If the column is 
not a character column that contains both 
SBCS and DBCS data (FOR MIXED DATA), the 
value of is 0. Ctherwise, the integer is not 
equal to 0. 


The rematning 12 bytes are reserved. 


Contains the name cr labe! of the column. 


Usage in FETCH, 
OPEN, and EXECUTE 


Specifies the address of an indicator variable. 
A negative value indicates null and a 
non-negative values indicates not null. The 
following cases might result 1n a null value, 
even though null values cannot be stored In 
tables: 


*  {facolumn function (MIN, MAX, COUNT, 
etc.) are specified in the SELECT list, 
and the GROUP BY clause was not 
specified. and tne result of COUNT Is 0, 
then a null value (-1) is returned tn the 
indicator varrabie for the column 
functions other than COUNT. 


* If adecimal data error occurred when 
evaluating an expression in the SELECT 
list. but a successful determination could 
still be made as to whether the resulting 
row should be selected, as many valid 
results will be returned as possitle, and 
items that encountered errors will be 
returned as a null value (-2). 


Not used. 
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Values of SQLTYPE 


The table below lists allowable values of the SQLTYPE field of an SQLDA, and their > | 
meanings. There are two values for each data type: 


e For DESCRIBE and PREPARE statements, the first value does not allow null 


values, but the second value does allow null values. 


e For FETCH, OPEN. and EXECUTE statements. the first value does not have an 
indicator variable. but the second value does have an indicator variable. 


Values 


448/449 
452/453 
456/457 
480/481 
484/485 
488/489 


496/497 
500/501 


The Included SQLDA 


DESCRIBE and 
PREPARE — 


Data Type Null Indicator? 
varying-length character no/yes 

string 

fixed-length character no/yes 

string 

long varying-lergth no/yes 


character string (greater 
than 254 bytes) 


floating point no/yes 
decimal no/yes 
numeric (zoned) no/yes 
large integer no’yes 
smal! integer nNo/yes 


FETCH, OPEN, and 
EXECUTE — 
Indicator Variable? 


no/yes 
no/yes 
no/yes 
no/yes 
no/yes 
no/yes 


no/yes 


no/yes 


J 


The description of the SQLDA that is given by INCLUDE SQLDA ts shown for PL/I: 


DCL 1 


SQLDA BASED (SQLDA°TR) , 

2 SQLDAID CHAR (8) , 

2 SQLDABC BIN FIXED (32), 
2 SQLN BIN FIXED, 

2 SQLD BIN FIXED, 

2 SQLVAR 99), 


3 SQLTYPE BIN FIXED, 
3 SQLLEN BIN FIXED, 

3 SQLRES — CHAR(12), 

3 SQLDATA PTR, 

3 SQLIND = PTR, 

3 SQLNAME CHAR(30) VAR; 


DCL SQLDAPTR PTR; 
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access path. The path used to locate data specified in 
SOL statements. An access path can be either indexed 
or sequential. or a combination of both. 


access plan. The control structure produced during 
compile time that is used to process SQL statements 
encountered when the program Is run. 


ANSI. American National Standards Institute 


application. A program or set of programs that perform 
a task; for example, a payroll! application. 


attribute. In data base design, a characteristic of an 
entity; for example, the telephone number of an 
employee is one of that employee’s attributes. 


authorization ID. A user profile. A name identifying a 
user to whom privileges can be granted. 


automatic bind. When an application program is being 
run and the access plan is not valid, binding takes 
place automatically: thatis, without a user issuing 
another precompile command. 


binary. An SQL data type indicating that the datais a 
binary number with a precision of 15 (halfword) or 31 
(fullword) bits. 


bind. The process by which the output from the SOL 
precompiler is converted to a usable structure called 
an access plan. This process is the one during which 
access paths to the data are selected and some 
authorization checking is performed. There are two 
types of bind used by SOQL/400: automatic and dynamic 
(see automatic bind and dynamic bind). 


catalog. Tables and views, maintained by the data 
base manager that contain descriptions of objects, such 
as tables, views, and indexes. 


catalog table. AS/400 system data dictionary physical 
files. 


catalog views. A set of views containing information 
about the objects in a data base, such as tables. views, 
indexes. and column definitions. 


character string. A sequence of bytes or characters 
associated with a single-byte character set. 


clause. A distinct part of a statement in the language 
structure, such as a SELECT clause or a WHERE 
clause. 


column. The vertical part of a table. A column has a 
name and a particular data type (for example, 
character, decimal, or integer). 


column function. A process that calculates a value 
from a set of values and expresses it as a function 
name followed by an argument enclosed in 
parentheses. 


commit. The process that data changed by one 
application or user to be used by other applications or 
users. When a commit operation occurs, the locks are 
released to allow other applications to use the changed 
data. 


commit point. The point in time when data is 
considered to be consistent. 


comparison operator. A symbol (such as =, >, <) 
used to specify a relationship between two values. 


concurrency. The shared use of resources by multiple 
interactive users or application programs at the same 
time. 


correlation name. An identifier that designates a table, 
a view, or an individual row of a table or view within a 
single SQL statement. The name can be defined in any 
FROM clause or in the first clause of an UPDATE or 
DELETE statement 


cursor. A named contro! structure used by an 
application program to point to arow of data. The 
position of the row is within a table or view, and the 
cursor is used to interactively select rows from the 
columns. 


data base. A set of objects created by SQL/400 that 
contains tables, views, indexes, and other system 
objects (such as a program) created by the user. An 
SQL data base consists of a library; a data dictionary 
that contains descriptions and information for all tables, 
views, indexes, and files created into the library; an 
SQL catalog: and a journal and journal receiver that 
are used to journal changes to all tables created into 
the data base. 


data type. An attribute of columns, constants. and host 
variables. 


DBCS. See doub/e-byte character set (DBCS). 


default value. A predetermined value, attribute, or 
option that is assumed when no other value is explicitly 
specified. For example. the value of acolumnisa 
nonnull value determined by the data type of the 
column. 
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delimited identifier. A sequence of one or more 
characters of the standard character set enclosed 
within SQL escape characters used to form a name. 


delimiter token. A string constant, a delimited 
identifier, a symbol (for example, ||, /, *, +, or —), or 
other special characters (for example, period, comma, 
parentheses). 


double byte character set (DBCS). A set of characters 
used by national languages, such as Japanese and 
Chinese. that have more symbols than can be 
represented by the 256 single-byte EBCDIC positions. 
Each character is 2 bytes in length, and therefore 
requires special hardware to be displ ayed or printed. 
Contrast with single-byte character set. 


dynamic bind. When SQL statements are entered 
interactively, binding is done dynamically (that is, as 
the SOL statements are entered). 


dynamic SQL. SQL statements that are prepared and 
processed within a program while the program is 
running. The SQL source statements are contained in 
host-language variables rather than being coded 
directly into the application program. The SQL 
statement might change several times while the 
program is running. 


EBCDIC. See extended binary coded decimal! 
interchange code (EBCDIC). 


embedded SQL. See static SQL. 


escape character. The symbol used to enclose a 
delimited identifier. This symbol is the quotation mark 
("), except in COBOL programs where the symbol can 
be assigned by the user as either a quotation mark or 
an apostrophe. 


expression. An operand, or acollection of operators 
and operands, that yields a single value. 


extended binary coded decimal interchange code 
(EBCDIC). A coded character set of 256 8-bit 
characters. 

fixed-length string. A character string whose length is 
specified and cannot be changed. Contrast with 


varying-length string. 


fullword binary. A binary number with a precision of 31 
bits. See also integer. 


full select. That form of the SELECT statement that 
includes ORDER BY or UNION operators. 


function. A column function or a scalar function. 


halfword binary. A binary number with a precision of 
15 bits. 
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COBOL, PL/I, and RPG, in which you can embed SQL 
statements. 


host language. Any programming language, such as 
) 


host structure. In an application program, a structure 
referred to by embedded SQL statements. In RPG, this 
is called a data structure; in PL/I, this is known as a 
structure; in COBOL , this is called a group item. 


host variable. In an application program, a variable 
referred to by embedded SQL statements. In RPG, this 
is called a frefd name: in PL/I, this is known as a 
variable; in COBOL, this is called a data item. 


identifier. See de/imited identifier and ordinary 
identifier. 


index. A set of pointers that are logically arranged by 
the values of a key. Indexes provide quick access to 
data and can enforce uniqueness on the rows in a 
table. 


index key. The set of columns in a table used to 
determine the order of indexed entries. 


indicator variable. A variable used to represent the 
null value in an application program. For example, if 
the value for the results column is null, SOL puts a 
negative value in the indicator variable. 


integer. An SQL data type indicating that the dataisa wil 
binary number with a precision of 31 bits. 


join. Arelational operation that allows retrieval of data 
from two or more tables based on matching column 
values. 


key. Acolumn or an ordered collection of columns 
identified in the description of an index. 


keyword. A name that identifies a parameter used in 
an SQL statement or SQL precompiler command. See 
also parameter. 


lock. The process by which integrity of data is ensured. 
The prevention of concurrent users from accessing 
inconsistent data. 


long string. A string whose actual length, or a 
varying-length string whose maximum length, is 
greater than 254 bytes or 127 double-byte characters. 


menu. A displayed list of available, logically grouped 
functions for selection by the operator. 


mixed data string. A character string that can contain 


both single-byte and double-byte characters. 


null. A special value that indicates the absence of r 
information. S) 


object. Anything that can be created or manipulated 
with SQL statements, such as data bases, tables, 
views, or indexes. 


ordinary identifier. A letter followed by zero or more 
characters, each of which is a letter ($, @, #, a-z, and 
A-Z),. anumber, or the underscore character used to 
forrn aname. Anordinary identifier must not be 
identical to a reserved word. 


ordinary token. A numeric constant, and ordinary 
identifier, a host variable, or a keyword. 


page. A unit of storage equal to 512 bytes. 


parameter. The keywords and va/ues that further 
define SOL precompiler commands and SQL 
statements. 


parameter marker. A question mark (?) that appears in 
a statement string of a dynamic SQL statement. The 
question mark can appear where a host variable could 
appear if the statement string was an embedded SQL 
statement. 


plan. See access plan. 


precompile. A processing of programs containing SOL 
statements that takes place before a compile. SQL 
statements are replaced with statements that will be 
recognized by the host language compiler. The output 
from this precompile includes source code that can be 


submitted to the compiler and used in the bind process. 


predicate. An element of a search value that 
expresses or implies a comparison operation. 


prepared SQL statement. A named control structure 
that is the form of an SQL statement that was 
processed by the PREPARE statement. 


privilege. A capability given te a user by the 
processing of a GRANT statement. 


rebind. The creation a new access plan for a program 
that was previously bound. If, for example, you add an 
index for a table that is used by your application 
program, SQL’/400 may automatically bind the 
application again to take advantage of that index. 


realtable. A physical file or a table created by SQL. 


recovery. The process of rebuilding data bases after a 
system failure. 


relational data base. A data structure perceived by its 
users as a collection of tables. 


result column. The set of column values that SOL 
selects for an application program. 


result table. The set of rows that SQL selects for an 
application program. The program uses a cursor to 
retrieve the rows one by one into a host structure or a 
set of host variables. 


rollback. The process of restoring data changed by an 
application to the state at its last commit point. 


row. The horizontal part of a table. A row consists of a 
sequence of values, one for each column of the table. 


runtime authorization ID. The user profile of the job 
invoking an SQL statement. 


SBCS. See single-byte character set (SBCS). 


scalar function. An operation that produces a single 
value from another value and expresses it in the form 
of a function name followed by a list of arguments 
enclosed in parentheses. 


search condition. Acriterion for selecting rows from a 
table. A search condition consists of one or more 
predicates. 


short string. A string whose actual length, or a 
varying-length string whose maximum length. is 254 
bytes. 


single-byte character set (SBCS). A character set in 
which each character is represented by a one-byte 
code. 


small integer. An SQL data type indicating that the 
data is a binary number with a precision of 15 bits. 


special register. A storage area whose primary useis 
to store information produced in conjunction with the 
use of specific SQL functions. The SQL/400 special 
register is (named) USER. 


SQL. See Structured Query Language. 
SQLCA. See SQL communication area (SQLCA). 
SQLDA. See SQL descriptor area (SQLDA). 


SQL communication area (SQLCA). A collection of 
variables that are used by SQL to provide an 
application program with information about the 
processing of SQL statements within the program. 


SQL descriptor area (SQLDA). A collection of variables 
that are used in the processing of certain SOL 
statements. The SQLDA is intended for dynamic SOL 
programs. 


static SQL. SQL statements that are embedded within a 
program, and are prepared during the program 
preparation process before the program isrun. After 
being prepared, the statement itself does not change 
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(although values of host variables specified by the 
statement might change). 


string. A character string. 


string delimiter. A symbol used to enclose an SQL 
string constant. This symbol is the apostrophe (’), 
except in COBOL applications, in which case the 
symbol (either an apostrophe or a quotation mark) may 
be assigned by the user. 


Structured Query Language (SQL). A language that can 
be used within host programming languages or 
interactively to access data and to control access to 
resources. 


subselect. That form of the SELECT statement that 
does not include ORDER BY or UNION operators. 


table. A named data object consisting of a specific 
number of columns and some number of unordered 
rows. 

token. See celimited token and ordinary token. 
union. An SQL operation that combines the results of 


two subselects. Union is often used to merge lists of 
values obtained from several tables. 
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unique index. An index that assures that no Identical ( 
key values are stored in a table. 


unit of recovery. A sequence of operations within a 
unit of work between two commit points. 


unlock. To release an object or system resource that 
was previously locked and return it to general 
availability. 


user profile. An object with a unique name that 
contains the user’s password. the list of special 
authorities assigned to a user, and the objects the user 
owns. See also authorization ID. 


value. Smallest unit of data manipulated in SQL. 


varying-length string. A character string whose length 
is not fixed, but variable within limits. Contrast with 
fixed-length string. 


view. An alternative representation of data from one or 
more tables. A view can include all or some of the 
columns contained in the table or tables on which itis 
defined. 


c 
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Special Characters 


See asterisk 
*APOST precompiler option 18 
“APOSTSQL precompiler option 18 
“COMMA precompiler option 18 
*PERIOD precome:ler option 18 
"QUOTE precompiler option 18 
"QUOTESQL precompiler option 18 
*SYSVAL precompiler option 18 
9 

See parameter marker 


A 
ALL 
clause of SELECT statement 40 
ALL PRIVILEGES 
clause of GRANT statement 86 
clause of REVOKE statement 105 
AND truth table 30 
ANY 
clause of DESCRIBE statement 75 
clause of PREPARE statement 102 
application process 5 
application program 
INSERT statementin 91 
arithmetic operator 24 
AS clause of CREATE VIEW statement 57 
AS/400 system precompiler 
"COMMA. “PERICD. and *SYSVAL options 
escape Character opiion for COBOL 8 
string delimiter options for COBOL 18 
use of INCLUDE statements 89 
ASC 
clause of CREATE INDEX statement 61 
clause of SELECT statement 47 
asterisk 
in SOL SELECT clause 40 
authorization ID 
description 11 
AVG function 31 


3) 


basic operationsin SQL 14 
basic predicate 27 
BEGIN DECLARE SECTION statement 52 
BETWEEN SOL predicate 27 
BOTH 
clause of DESCRIBE statement 75 
clause of PREPARE statement 102 
built-in function 31 
for columns 31 


built-in function (continued) 
for scalars 34 
nesting of 34 


C 


catalog 4 
CHAR 
data type for CREATE TABLE 63 
character string 
assignment 15 
comparison 16 
description 12 
empty 12 
characters in SQL 7 
CLOSE statement 53-54 
closed state of cursor 99 
COBOL application program 
See also application program 
escape character in 8 
host structures in 22 
host variable in 21, 82 
varying-length string variablesin 12 
varying-length string variables not allowed In 
COLUMN 
clause of COMMENT ON statement 55 
clause of LABEL ON staiement 94 
inaresult 41 
rules for. with UNION 45 
column function 
See function 
column name 9. 19 
commands 
help for CL cammands iv 
comment in catalog table 55 
COMMENT ON statement 
column name qualification 19 
SQL statement 55-56 
commit 5 
commit point 57 
HOLD clause of COMMIT statement 57 
COMMIT statement 57—58 
comparison ofnumbers 16 
compatibility rules 14 
comparison of strings 16 
compatibility rules 14 
compatibility of datatypes 14 
concatenation operator 24 
concurrency 
In application processes 5 
with LOCK TABLE statement 96 
constant in SQL 
character string 17 
decimal 17 
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constant in SQL (continued) 
floating-point 17 
integer 17 
CONTINUE 
clause of WHENEVER statement 114 
conversion of numbers 15 
errors 110 
correlation-name 
defining 20 
description 9 
in FROM clause of SELECT 43 
qualifying acolumnname by 20 
COUNT function 32 
CREATE DATABASE statement 59 
CREATE INDEX statement 60—61 
CREATE TABLE statement 62—65 
CREATE VIEW statement 66—67 
cursor 
active set 98 
closed by error during UPDATE 113 
closing 53 
COMMIT statement 57 
defining 68 
in closed state 99 
moving position of 84 
preparing 98 
cursor-name 9 


D 

data base 
creating 59 
dropping 78 

data type 


character string 12 
for CREATE TABLE 63 
inSQL 12 
numeric 13 
resuiltcolumns 41 
DATABASE 
clause of CREATE DATABASE statement 59 
clause of DROP statement 78 
database-name 9 
decimal arithmetic 25 
decimal constants 17 
DECIMAL data type 
for CREATE TABLE 63 
DECIMAL function 34 
decimal numbers 13 
declaration. inserting into a program 89 
DECLARE CURSOR statement 68—70 
DECLARE STATEMENT statement 71 
DELETE 
clause of GRANT statement 87 
clause of REVOKE statement 105 
SQL statement 
effect of temporary table 99 
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DELETE statement 72-74 
deleting 
SQL objects 77 
delimited identifier in SQL 8 
DESC 
clause of CREATE INDEX statement 61 
clause of SELECT statement 47 
DESCRIBE statement 75-76 
DESCRIPTOR 
clause of EXECUTE statement 80 
clause of OPEN statement 99 
descriptor-name 9 
DIGITS function 35 
DISTINCT 
clause of SELECT statement 40 
double precision floating-point 13 
double-byte character 
in character strings 12 
in COMMENT ON 56 
in LIKE predicates 29 
truncated during assignment 16 
DROP statement 77—78 
duplicate rows with UNION 45 
dynamic SOL 
DESCRIBE 75 
EXECUTE IMMEDIATE 82 
executing by EXECUTE 80 
prepared by PREPARE 101 


E 
empty character string 12 
END DECLARE SECTION statement 79 
error 
closes cursor 99 
in arithmetic expression 110 
in numeric conversion 110 
escape character in SQL 
delimited identifier 8 
evaluation. order of 26 
EXCLUSIVE clause of LOCK TABLE statement 95 
EXECUTE IMMEDIATE statement 82-83 
EXECUTE statement 80-81 
executing 
prepared SQL statements 80-81 
SOL by EXECUTE IMMEDIATE 82 
expression 
description 24 
order ofevaluation 26 
result 24 


F 
FETCH statement 84—85 
field procedure 
with LIKE predicates 29 
FLOAT data type 
for CREATE TABLE 63 
FLOAT function 35 
floating-point constants 17 
floating-pointnumbers 13 
FOR BIT DATA 
clause of CREATE TABLE statement 64 
FOR UPDATE OF 
clause of DECLARE CURSOR statement 48 
clause of SELECT statement 48 
prohibited in views 67 
FROM 
clause of PREPARE statement 102 
clause of REVOKE statement 106 
clause of SELECT statement 42 
from-clause 42 
fullselect 44, 45 
function 
column 
AVG 31 
COUNT 32 
MAX 32 
MIN 33 
SUM 33 
description 31 
nesting 34 
scalar 
DECIMAL 34 
DIGITS 35 
FLOAT 35 
INTEGER 36 
LENGTH 36 
SUBSTR 37 


G 
GO TO 
clause of WHENEVER statement 114 
GRANT statement 86—88 
GROUP BY 
cannot join view using 67 
clause of SELECT statement 43 
results with SELECT 41 
group-by-clause 43 
grouping column 43 


H 


HAVING 
clause of SELECT statement 44 
results with SELECT 41 
having-clause 44 
help 
for CL commands, online’ iv 
for displays iv 
for SQL precompiler commands, online — iv 
host structure 
description 22 
host variable 9, 21 
in EXECUTE IMMEDIATE 82 
in FETCH 84 
in SELECT INTO. 110 
substitution for parameter markers 80 
with PREPARE 102 


identifiersin SQL 8 
IN 
SQL predicate 29 
IN EXCLUSIVE MODE clause of LOCK TABLE 
statement 96 
IN SHARE MODE clause of LOCK TABLE statement 
INCLUDE statement 89 
INDEX 4 
clause of CREATE INDEX statement 60 
clause of DROP statement 78 
clause of GRANT statement 87 
clause of REVOKE statement 105 
dropping 78 
index search iv 
index-name 10 
indicator structure 23 
indicator variable 82 
INSERT 
clause of GRANT statement 87 
clause of REVOKE statement 105 
SQL statement 90, 93 
effect of temporary table 99 
inserting 
declarations in a program 89 
integer constants 17 
INTEGER datatype 13 
for CREATE TABLE 63 
INTEGER function 36 
interactive select 47 
INTO clause 
of DESCRIBE statement 75 
of FETCH statement 84 
of INSERT statement 91 
of PREPARE statement 102 
of SELECT statement 109 
IS 
clause of COMMENT ON statement 56 
clause of LABEL ON statement 94 
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L 
LABEL 
in catalog tables 94 
LABEL ON 
column name qualification 19 
SQL statement 94-95 
LABELS 
clause of DESCRIBE statement 75 
clause of PREPARE statement 102 
large integers 13 
length attribute of column 12 
LENGTH function 36 
LIKE SQL predicate 28 


limit 
Sou. Vil? 
literals 17 
LOCK TABLE statement 96—97 
locking 


COMMIT statement 57 
description 5 

during UPDATE 113 
table spaces 96 

with LOCK TABLE 96 


M 


marker. parameter 
See parameter marker 
MAX function 32 
MIN function 33 
mixed data 
in LIKE predicates 29 
in string assignments 16 
when itis in effect 12 
MODE 
clause of LOCK TABLE statement 96 


N 
NAMES 
clause of DESCRIBE statement 75 
clause of PREPARE statement 102 
naming 
SQL statements 71 
Naming conventions in SQL 9 
NOT FOUND clause of WHENEVER statement 
NOT NULL clause of CREATE TABLE statement 
NOT NULL WITH DEFAULT 
clause of CREATE TABLE statement 63 
NULL 
in CREATE TABLE 63 
null value in SOL 
assigned to host variable 110 
assignment of 14 
defined 12 
in duplicate rows 45 
in grouping columns 44 
inresultcolumns 41 
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null value in SQL (continued) 
resulting fromerrors 110 
numbers in SQL 13 
numeric 
assignments inSQL_ 14 
comparisons 16 
numeric conversionerrors 110 
numeric data types 13 
numeric numbers 14 


O 


object table 20 
ON clause of CREATE INDEX statement 61 
online 
index iv 
OPEN statement 98—100 
Operation in SOL 
assignment 14 
comparison 14 
oper ator 
arithmetic 24 
concatenation 24 
OR truth table 30 
ORDER BY 
clause of SELECT statement 47 
prohibited in views 67 
order-by-clause 47 
ordinary identifier inSQL 8 


Pp 

parameter marker 
in EXECUTE 80 
in PREPARE 103 


with OPEN 99 
parameter markers, rules 103 
parentheses 


with UNION 45 
PL/I application program 

See also application program 

host structures in 22 

host variable in 21 
precedence level 26 
precedence of operation 26 
precisionofanumber 13 
precision of data 

in CREATE TABLE 63 
predicates in SOL 

basic 27 

BETWEEN 27 

description 26 

IN 29 

LIKE 28 

result 27 
PREPARE statement 101-104 
prepared SQL statement 

dynamically prepared by PREPARE 101-104 

executing 80-81 


prepared SQL statement (continued) 
identifying by DECLARE 71 


obtaining information by DESCRIBE 75 
obtaining information by INTO with PREPARE 76 


PUBLIC 
clause of GRANT statement 87 
clause of REVOKE statement 106 


Q 


qualification of column names 20 
queries 37 
question mark 

See parameter marker 


R 


read-only table 68 
read-only view 67 
recovery 

unit of 

See unit of recovery 

resultcolumns of SELECT 41 
REVOKE statement 105. 106 
rollback 5 
ROLLBACK statement 107—108 
row 

deleting 72 

inserting 90 
RPG application program 

See also application program 

host variable itn 21 82 
rules fornamesinSOL 9 


S 


scale of data 
in comparisons inSQL_ 16 
in conversion of numbers inSQL 15 
in CREATE TABLE 63 
in results of arithmetic operations 25 
inSQL_ 13, 14 
search condition 
description 30 
order of evaluation 30 
result 30 
with DELETE 73 
with HAVING 44 
with UPDATE 112 
with WHERE 43 
SELECT 
clause inSQL 40 
clause of GRANT statement 87 
clause of REVOKE statement 105 
result columns of 41 
SOL statement 109. 110 
full 45 
interactive 47 
subselect 39 


select list 
application 41 


maximum number of elements and functions 


notation 40 
select-clause 40 
select-statement 46 
SET clause of UPDATE statement 112 
SHARE clause of LOCK TABLE statement 
shift-in character 

in SQL character strings 12 

not truncated by assignments 16 
shift-out character 

in SQL character strings 12 
single precision floating-point 13 
small integers 13 
SMALLINT data type 

for CREATE TABLE 63 
special register 18 

USER 19 
SQL (Structured Query Language) 

assignment operation 14 

basic operations 14 

character strings 12 

characters 7 

comparison operation 14 

concepts 3 

constants 17 

datatypes 12 

dynamic 4 

embedded 3 

escape character 8 

identifiers 8 

limits 117 

naming conventions 9 

null value 12 

numbers 13 

shift-out and shift-in characters 12 

Static 3 

Structured Query Language (SQL) 


96 


See SOL (Structured Query Language) 


tohens 7 

value 12 

variable names used 9 
SQL statement 81 

BEGIN DECLARE SECTION 52 

CLOSE 53-54 

COMMENT ON 55—56 

COMMIT 57—58 

CREATE DATABASE 59 

CREATE INDEX 60-61 

CREATE TABLE 62-65 

CREATE VIEW 66—67 

DECLARE CURSOR 68-70 

DECLARE STATEMENT 71 

DELETE 72-74 

DESCRIBE 75-76 

DROP 77-78 

END DECLARE SECTION 79 
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SQL statement (continued) 


EXECUTE 80 
EXECUTE IMMEDIATE 82—83 
FETCH 84—85 
getting information about 75 
GRANT 86-88 
INCLUDE 89 
INCLUDE statement 89 
INSERT 90-93 
LABELON 94-95 
LOCK TABLE 96-97 
names for 71 
OPEN 98-100 
PREPARE 101—104 
REVOKE 105-106 
ROLLBACK 107-108 
SELECT 109, 110 

full 45 

interactive 47 

subselect 39 
UPDATE 111-113 
WHENEVER 114-115 


SQL statement option 


ALL 105 
in SELECT 40 
ALL PRIVILEGES 6&6 
ANY 
after DESCRIBE...USING 75 
after PREPARE...USING 102 
AS 67 
ASC 47,61 
BOTH 75. 102 
COLUMN = 55, 94 
CONTINUE 114 
DATABASE 59, 78 
DELETE 
effect of temporary table 99 
in GRANT 87 
in REVOKE 105 
DESC 
with CREATE INDEX 61 
with SELECT 47 
DESCRIPTOR 80, 99 
DISTINCT 40 
FOR BIT DATA 
after CREATE TABLE 64 
FOR UPDATE OF °48 
FROM 
after PREPARE 102 
after REVOKE (106 
after SELECT 42 
GOTO 114 
GROUP BY 43 
HAVING 44 
HOLD 57 
IN EXCLUSIVE MODE 96 
INSHARE MODE 96 
INDEX 
after CREATE 60 
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SQL statement option (continued) 
INDEX (continued) 
after DROP 78 
after GRANT 87 
after REVOKE 105 
INSERT 87, 105 


effect of temporary table 99 


INTO 75 


after embedded SELECT 109 


after FETCH 84 
after INSERT 91 
after PREPARE 102 
IS 56, 94 
LABELS 75, 102 
NAMES 75. 102 
NOT FOUND 114 
NOT NULL 63 
NOT NULL WITH DEFAULT 
after CREATE TABLE 63 
ON 61 
ON TABLE 87, 106 
ORDER BY 47 
PUBLIC 87, 106 
SELECT 87, 105 
SET 112 
SOLERROR 114 
SQOLWARNING 114 
STATEMENT 71 
TABLE 
afer CREATE 62 
with COMMENT ON 55 
with DROP 77 
with LABELON 394 
Os 20x 
UNION 45 
UNIQUE 60 
UPDATE 105 


effect of temporary table 99 


USING 
with DESCRIBE 75 
with EXECUTE 80 
with OPEN 98 
with PREPARE 102 
USING DESCRIPTOR 84 
VALUES 91 
VIEW 66, 77 
WHERE 
after DELETE 73 
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